Not just witty comments in your code: Documentation best practices for themes, plugi...
summary
Argues that documentation must be actionable: use phpDocumentor to generate static HTML from docblocks, use Swagger/Apiary plus JSON examples for REST endpoints and list expected error responses, and use Postman to validate generated snippets. Recommends minimum docblocks for classes and methods, chunked CSS or Sass sections, step‑by‑step user guides with screenshots, and a support/knowledge base (BBPress or Zendesk). Claims comments speed onboarding and suggests erring on slightly more detail rather than less.
AI-written summary · about
