The docspec is a specification for an interoperable file format that documenting tools, like JavaDoc, can use. These tools normally work in 3 steps:
- Parsing the code mapping docblocks to code
- Generate an abstract format with the contents for the documentation
- Generate the documentation
The docspec is the output of the second step. This would decouple the parsing step from the output step, so that these two things could be developed independently. With the goal that there will be a pool of various documenting tools and a pool of various display tools and that makes it easy for end users to combine them on their needs.
none yet, yay this is totally new. If you are a doctool author and have interesst in implementing the docspec, feel free to fork this file and add yourself.
- phpdoctor [Language: PHP]
See issue: peej/phpdoctor#58
2012-01-02 Created first draft version
- My Blog Post
- PSR (PSR = PHP Standards RFC, it is a form of RFC for the PHP Standards Group)
Demo at: http://demo.docblox-project.org/default/structure.xml