<div dir="ltr"><div>Hi LRUG,</div><div><br></div><div>Two points here:</div><div><br></div><div>* I'd like to introduce the Ruby Hacking Guide</div><div>* I'd like to ask a question about side-by-side documentation solutions</div>

<div><br></div><div>Ruby Hacking Guide</div><div>_________________</div><div><br></div>About a year ago, I decide to renew the efforts to translate a guide to the internals of Ruby (1.7). I got as far as setting up a GitHub group and project and co-ordinating the various efforts that had been made to translate it from the original Japanese.<div>

In the last month or so contributions, input, feedback and pull requests have rocketed. It got to number 14 on the trending ruby projects on github and number 3 on Hacker News.</div><div>I'm mostly pleased that we're nearly at a releasable full translation, slightly mixed with embarrassment at how little I've done.</div>

<div>Anyway, it's not 100% translated/polished yet, but if you'd like to take a look, then it's at <a href="http://ruby-hacking-guide.github.io/">http://ruby-hacking-guide.github.io/</a> or <a href="https://github.com/ruby-hacking-guide/ruby-hacking-guide.github.com/">https://github.com/ruby-hacking-guide/ruby-hacking-guide.github.com/</a> for the source.</div>

<div><br></div><div>Question</div><div>-------------</div><div><br></div><div>In order to maintain accuracy of the original translation, particularly when tweaking the phrasing of the English to sound more natural, it's important to refer regularly back to the original. As such I'd like to have a solution similar to the literate coffeescript style of documentation. </div>

<div><a href="http://coffeescript.org/documentation/docs/grammar.html">http://coffeescript.org/documentation/docs/grammar.html</a><br></div><div><br></div><div>I.e. 'comments' equate to the original Japanese, and 'source code' equates to the English.</div>

<div>Then multiple views of the translation can occur. One aimed at translators, one at English speakers, one at Japanese speakers. </div><div><br></div><div>Having a quick look through documentation solutions out there they are mostly focused on specific programming languages. E.g. docco, rocco, etc.</div>

<div><br></div><div>I'd rather not roll my own if something is out there already. So, is anyone aware of something that will allow me to use markdown/textile formatting just to do the side-by-side comparison view?</div>

<div><br></div><div><br></div><div>Regards,</div><div><br></div><div>Mark</div></div>