On Tue, 9 Mar 1999, Markus Baeurle wrote:

> That's exactly the reason why I was asking. :-)
> OK, how do we go about it?
> Last time (pretty long ago) we were discussing documentation was when we
> thought about using LinuxDoc or whatever document format the FreeBSD people
> were using for their Handbook etc. I think I'll have a look at this first,
> but if anybody has experience with this, I'd like to hear from him.
> The benefit of using such a format is that you can get all kinds of document
> formattings out of it, HTML, ASCII, LaTeX etc... so I think it's really worth
> to use it.
> 
	I think everytime we start on this it all bogs down on the format
	and we don't actully get any more information up :(

	At the moment we have a simplistic perl script that takes html
	with a couple of extra special tags and outputs normal html with
	a set of indexes and appropriate '<a name=...' links. It works
	quite well and takes most of the pain out of adding entries.

	(Check out http://www.netbsd.org/Ports/arm32/faq.faq)

> That's where users like me can help out. We just need to define how the
> documents are to be written (document format, maybe some style rules), who
> maintains them and how submissions can be made.
> 
	Actually we were looking for someone to keep and eye on each
	port-* list and collect entries for the FAQs. For now the rules
	are simple: Let us know you're interested and email entries as
	HTML (or even text) to www@netbsd.org :)

	We're trying to keep the non port specific answers under
	http://www.netbsd.org/Documentation/

	If you have the time - please let us know!

		David/absolute