user-guide.pdf is about twenty years out of date

[eddieantonio]

Need to update this documentation. I contacted Dr. Steven Rice, but unfortunately (read: unsurprisingly—it's been 20 years) they do not have the source for this document.

While we're at it, might as well publish this on readthedocs.org. It boasts automatically producing HTML, PDF, and ebook output!

[amitdo]

Another option is using markdown + pandoc.

Copyright © 1996 by the Information Science Research Institute.
All rights reserved. This document may not be reproduced in whole or in part by any
means without permission.

Maybe you can ask Mr. Rice if you can change this to Apache 2.0 or Creative Commons BY-SA 4.0 license?

What about the manpages ? This tool seems useful:
https://github.com/rtomayko/ron

[eddieantonio]

Yikes! That copyright that I didn't notice is an even bigger issue; I pretty much need to get that PDF out of this repo soon (though because nobody, including Steven Rice, hasn't said anything, we might still be okay for a while). Thanks for point that out!

---

I didn't know about ronn! I've been using pandoc+markdown successfully for writing man pages, but ronn seems to have some nice little features that are more manual using my approach.

And the reason I wanted to use readthedocs.org is because it's much more automatic than building documentation using pandoc+markdown. You just create docs/, add a GitHub hook and it compiles and publishes the latest version of the documentation automatically. It's really nice!

Plus it supports markdown!

[amitdo]

Plus it supports markdown!

I didn't know that.