rich Posted October 21, 2014 Share Posted October 21, 2014 Hi all, I've been slowly working away on DocGen, our tool for generating the new Phaser API documentation. It was built to bridge the issues between Phaser and Pixi jsdoc format incompatibilities and to take the API docs to the next stage. Tonight I got it to a point where it's outputting everything as json data. The json files contain every method and property for every class, including all inherited ones, properly formatted return types, inline help, line numbers and everything else you should need. The next stage is to output them as markdown files, but I'd love if some of you can check the JSON structure and see if you can spot any mistakes or missing things. I figured having the API docs in a json format could be handy in lots of cases, especially with online game editors like MightyEditor. Plus it lets you write your own interface too, and maybe we could see a Sublime Editor code-completion plugin now You can get the JSON output from here: https://github.com/photonstorm/phaser/tree/dev/docgen/output Please post your comments here. Cheers, Rich clark 1 Link to comment Share on other sites More sharing options...
OttoRobba Posted October 22, 2014 Share Posted October 22, 2014 Awesome! Link to comment Share on other sites More sharing options...
fhefh Posted October 23, 2014 Share Posted October 23, 2014 nice, good~~how to make a docset, that can use dash to find apis Link to comment Share on other sites More sharing options...
xerver Posted October 23, 2014 Share Posted October 23, 2014 Just a head up if there is any confusion, Pixi.js uses YUIDoc format since most things are class based; not jsdoc. You should be able to just use their parser in addition to the jsdoc parser and combine the output. Link to comment Share on other sites More sharing options...
Recommended Posts