Added an example of how to document docblock properties

- Also added .idea to .gitignore for those of us that use PHPStorm to edit markdown
You dont need to define the `as Foo` if the name is matching. In fact, this will probably error. 

Also this code is not inside a namespace, so it doesnt even need to have a `use` in the first place. Maybe put it inside a namespace?