php-doc

Documentation (phpDoc)

• GOLDEN RULE: Never duplicate signature information without adding value
• For trivial methods where class, method name, and parameter names explain everything
• When documentation would only repeat signature information
• Clearly define purpose/responsibility
• Use active phrasing describing main responsibility
• Avoid unnecessary words
• Be concise and direct

Class Documentation

Writing Style

• Skip phrases like "Class that..." or "Interface for..."
• Don't duplicate method lists or implementation details

Property Documentation

• Use single-line format for simple @var annotations: