Added an example of how to document docblock properties

- Also added .idea to .gitignore for those of us that use PHPStorm to edit markdown
Can we be consistent with the approach? If we're using one we should probably use the other.