Hey Josh, It's great to know that you're interested in helping out on the documentation update!
Indeed, the old Ruby generator has served us well but it's dated and becoming a hindrance to our productivity. A straight rewrite in node is not how I want to approach. Programming languages come and go. Node is popular with Cordova right now, but Ruby was the go-to language for PhoneGap 4 years ago. In the past four years, we've learned a lot of what's good and bad about our documentation. Cordova has also been introduced to new requirements that we previously never considered - multiple languages, way more content, plugins, guides, and distributions wanting to rebrand the docs. The lack of communication is entirely my fault. I'll kick up a new ML thread and start creating issues to lay the ground work. We can then all loop back and chat. Michael On Mon, Dec 9, 2013 at 8:20 PM, Brian LeRoux <[email protected]> wrote: > > >> I think a note in the README for docs indicating that the code is being >> rewritten (with a bug link and an ETA) would have prevented me from >> investing time in it. > > > Probably. But this is Apache and nothing happens at Apache unless it > happens on the mailing list. Friendly note saying, "hey guys, this ancient > ruby junk is fucking retarded: I'M GOING IN" is the best way to make sure > we're not trampling each other. > > > >> I'd like to see the Ruby code gone by 3.4, or 3.5 at the latest. We have >> plenty of hands who are familiar with JavaScript / Node.js, and probably >> countably few who know Ruby... >> > > I'd like to see it gone too. > >
