News for hackers. Stuff that matters.
Re:Ask HN: Can I write all my doco using markdown? by chrishorsley on Thursday January 06, 2011 @08:03PM (#2078072)
Here's an experiment we are running here for our technical documents.

We have an Etherpad server (http://etherpad.org/) we heavily use, and we've used it to write some of our technical docs in Markdown. We use other pads to define HTML templates. Then, we have simple web app which merges a chosen HTML template with the Markdown content, which lets the user preview the rendered results before saving the final HTML output.

Advantages: you get all Etherpad's realtime collaboration goodness, automatic version control and revision history, the HTML templates can be edited simply (and restricted to editing by certain users), it's pretty quick to pick up. Disadvantages: Etherpad is primarily text based so you're SOL if you need diagrams etc, slight complexity of the parts (templates, content, web app) to make it run.

Re:Ask HN: Can I write all my doco using markdown? by DamonOehlman on Thursday January 06, 2011 @08:23PM (#2078140)
Sounds like a pretty nifty way of doing things, I might try running up an etherpad server at some stage and going down a similar track.

I'm setting something up at a shell level using Jekyll (http://jekyllrb.com/). Won't have the collaboration goodness, but I guess it could be transitioned over to Etherpad at a later date.