…

Also wordpress ate your example url.

Personally I like this approach quite much, maybe because it looks quite similar to the approach we discussed at work for documenting our properties.

Anyway, while reading your blog post it came to my mind, that one could simply move the property docs, where they belong, to avoid poluting the class-level docblocks: To the __get/__set/__call method. This would mean that you would have to document read/write properties twice, which could by worked around by simply adding the tags for the properties, but only documenting their description once. See this example