Re: Documentation generation in pure Node.JS

2015-01-06 Thread Marcel Kinard
Woohoo! > On Thu, Dec 25, 2014 at 12:02 AM, Andrey Kurdumov > wrote: > >> README.md updated and Ruby files deleted. >> Also create script which should replace Rakefile in case if somebody need >> it. - To unsubscribe, e-mail:

Re: Documentation generation in pure Node.JS

2014-12-30 Thread Andrew Grieve
Merged! On Thu, Dec 25, 2014 at 12:02 AM, Andrey Kurdumov wrote: > README.md updated and Ruby files deleted. > Also create script which should replace Rakefile in case if somebody need > it. > > See there: https://github.com/apache/cordova-docs/pull/249 > > 2014-12-23 22:28 GMT+06:00 Andrew Grie

Re: Documentation generation in pure Node.JS

2014-12-24 Thread Andrey Kurdumov
README.md updated and Ruby files deleted. Also create script which should replace Rakefile in case if somebody need it. See there: https://github.com/apache/cordova-docs/pull/249 2014-12-23 22:28 GMT+06:00 Andrew Grieve : > This is now merged. Woot! > What I did: > - Looked through the code (ski

Re: Documentation generation in pure Node.JS

2014-12-23 Thread Andrew Grieve
This is now merged. Woot! What I did: - Looked through the code (skimmed mostly) - Ran bin/genjs - Ran npm test - spot-checked output within public/test Everything looks great to me! Only things I did: - Squashed into a single commit - Removed trailing whitespace - Added a couple of missing semicol

Re: Documentation generation in pure Node.JS

2014-12-18 Thread Andrey Kurdumov
Does anybody except Michael look on the documentation generation? I need this as a basis for future work on tools which helps me increase quality of translation. For first I want to have tool which ensures that autolinking in translated docs is working in same places as in original English translat

Re: Documentation generation in pure Node.JS

2014-12-11 Thread Michael Brooks
Andrey, you're approach sounds incredibly thorough! I'll set aside some time to test your pull request and see how it runs on my system. Today is already full, so I'll try to have some time set aside for tomorrow or the weekend. If anyone else is available to test it, that would be great as well!

Re: Documentation generation in pure Node.JS

2014-12-10 Thread Andrey Kurdumov
Thanks, 1. Already play with marked options and don't find any way to resolve that using that path. Now I done following: a) Generate latest docs using Ruby & JS b) Made changes to the original MD files, so previously generated version with Ruby will match with generated using JS c) Reg

Re: Documentation generation in pure Node.JS

2014-12-08 Thread Michael Brooks
Hi Andrey, 1. marked is certainly the most popular and active markdown generate for node. You may want to consider playing around with the options it offers. 2. _index.json was produced by the original joDoc generator, so the node-version may not support it. To the best of my knowledge, no one us

Re: Documentation generation in pure Node.JS

2014-12-06 Thread Andrey Kurdumov
Hi all, Bumping this thread again, since looks like I almost finish port Ruby version of documents generation to JS. I fix issues which you discover last time, and create validation script which theoretically could spot differences between old version and new one. So far everything looks good exce

Re: Documentation generation in pure Node.JS

2014-11-04 Thread Michael Brooks
Hi Audrey, Thanks for tackling this issue! Truth be told, we want to move away from jsdoc entirely. Years ago, we thought that the auto-linking and other auto-magical aspects of jsdoc would be nice, but it's caused more problems than good. The ruby environment is also troublesome, although we've

Re: Documentation generation in pure Node.JS

2014-11-04 Thread Andrey Kurdumov
I also find that links in Guides is missing. Not yet sure why is that looking into that. Issue which Shazron discover should be fixed now. 2014-11-04 3:00 GMT+06:00 Michal Mocny : > Just tried it using the steps Shaz listed on the PR and its working for me > fine. However, there are some warning

Re: Documentation generation in pure Node.JS

2014-11-03 Thread Michal Mocny
Just tried it using the steps Shaz listed on the PR and its working for me fine. However, there are some warnings during generation (bunch of "Did not found link for the keyword"), and the generated pages appear to have some links missing (such as the first page, Guides do not link to anything).

Re: Documentation generation in pure Node.JS

2014-11-03 Thread Andrew Grieve
Love that you're working on this! On Mon, Nov 3, 2014 at 12:57 AM, Shazron wrote: > Thanks Andrey, > I tested it out but I ran into problems. See my comment on your pull > request. > > On Sun, Nov 2, 2014 at 1:11 PM, Andrey Kurdumov > wrote: > > > Hello guys, > > > > I almost finish implementin

Re: Documentation generation in pure Node.JS

2014-11-02 Thread Shazron
Thanks Andrey, I tested it out but I ran into problems. See my comment on your pull request. On Sun, Nov 2, 2014 at 1:11 PM, Andrey Kurdumov wrote: > Hello guys, > > I almost finish implementing > https://issues.apache.org/jira/browse/CB-6751 > > In short this is implementation of Cordova Docs w