What is Transcription?
Transcription is an ECMAScript 6 (ES6) documentation generator designed to provide JSON, Markdown, and template driven HTML output.
What can I expect from Transcription as development continues?
-
Mutliple output formats. Flexible options should provided as each project and enviorment is unique. Transcription will out JSON structures (See Dox), Markdown (See Markdox), and template driven HTML output (See JSDoc).
-
Dynamically linked projects and classes. One feature missing from many JavaScript documentation generators in linking to projects and classes outside of the scope of one single file. This is a feature that Transcription will aim to provide.
-
Verify AST structures against JSDoc params. Becuase we have a proper AST object to compare with JSDoc doclets, an analysis will be peformed to verfiy that your comments matches the elements they are describing. This will developers track down any comments that become out of date, and inconsistencies that develop.
-
Gulp npm module. After basic functionality has been implemented and tested, Transcription should be easy to integrate into your build system.
How can I use Transcription?
You can see Transcription in action on your own system by following these steps: (Dependant on Git and Node.js)
npm install transcription- One of the following commands: (For JSON, Markdown, and HTML respectively)
transcription --helptranscription -f html -i ./input -o ./outputtranscription -f html -o ./output.html < ./input/controller.jstranscription -f html -o < ./input/controller.js > ./output/controller.htmltranscription -f html -i ./input.html > ./output/controller.js