Documentation/docblocks

I am wondering why there is no section of documentation or docblocks. Is it conventional to leave them out? What is the reason I don't see any docblocks in the open-sourced projects you guys have?

I would love to hear thoughts about using docblocks in Javascript. I find them really helpful when I am programming PHP. Especially if your IDE has support for it and can help you out with the documentation.

The issue names no files, tests, or entry points and asks for opinions about JavaScript docblocks rather than a specific documentation change. Read the existing discussion first; the work is not ready to start until the project decides whether docblocks belong in the style guide and defines the expected documentation scope.

Written by the indexing model from the issue text.