[plt-scheme] Questions about PLaneT documentation options

From: Matthias Felleisen (matthias at ccs.neu.edu)
Date: Fri Nov 5 12:27:42 EST 2004

On Nov 5, 2004, at 11:27 AM, Williams, M. Douglas wrote:

> The doc.txt format isn’t suitable for complete user documentation of 
> complex collections.  Should I provide a doc.txt that provides 
> rudimentary documentation?  Should doc.txt provide directions on 
> getting the complete reference manual?  Should the pdf file be 
> distributed as part of the collection?

Yes, add the abstract as a doc.txt and then point to the pdf file. If I 
were a user, I'd love to get the docs with the distribution. Jacob?

> It seems that much of the PLT Scheme documentation is done using (some 
> variation of) TeX and then using it to generate the HTML 
> documentation.  If this is the preferred method, what is the best way 
> to get started with TeX?

Get a book on latex. It's not too bad after you get used to it. Kind of 
like 6809 assembly language for Mac's window system.

-- Matthias

Posted on the users mailing list.