Summaries should be clear, simple, and brief. Class members (including properties and constants).
The following is a list of what should be documented in WordPress files: PHP documentation in WordPress mostly takes the form of either formatted blocks of documentation or inline comments. WordPress uses a customized documentation schema that draws inspiration from PHPDoc, an evolving standard for providing documentation to PHP code, which is maintained by phpDocumentor.
