Plaintext documentation

Brian Candler B.Candler at pobox.com
Fri Jun 24 10:14:37 CEST 2011


On Thu, Jun 23, 2011 at 10:54:38PM +0200, Arran Cudbard-Bell wrote:
> Wouldn't it be wonderful if there was a system where users and developers
> could both contribute content, quickly and easily, without having to learn
> GIT, in a format that closely resembles plaintext.

markdown is wonderful, especially the [pandoc] variant. There's also a wiki
called [gitit] built on pandoc.  The backend is git, but users don't know
this.  It lets you do extremely cool things like downloading wiki pages as
PDFs, and viewing wiki pages as slideshows.

[pandoc]: http://johnmacfarlane.net/pandoc/
[gitit]: http://gitit.net/

reStructuredText comes a close second.

Cheers,

Brian.



More information about the Freeradius-Devel mailing list