forrest-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Ferdinand Soethe <samm...@soethe.net>
Subject Re: documentation additions and issue tracking (Was: App vs Data)
Date Wed, 01 Jun 2005 08:25:28 GMT
As you might know Ross and I have put considerable time into working
on a chapter structure for a book on Single Source Publishing with
Forrest. Since we didn't follow through with the project (there will
only be a German book) we are prepared to donate this structure (more
precisely: the rights to this concept for an English publication) as a
basis for the Forrest documentation project.

It might need some adjustments of course, but it was designed to
introduce people with basic skills to Forrest so it seems compatible
with what Addi had in mind.

If people think this is helpful, I'd check the OpenOffice file with
the concept into the issue tracker so that people can study it and add
their comments and suggestions (preferably as a modified
OpenOffice-document). Or is OpenOffice too proprietary to work with?

Once we have finalized the chapter structure, we could create it as a
new tab on Forrest main site with each chapter becoming a menu item
pointing to a page with a short abstract for this chapter (not being
written yet) and instructions on what to do if person wants to write
and contribute this chapter.

All open chapters could also become items in the issue tracker but I
think that having them in a structured menu helps recognizing at what
point in the documentation this chapter is placed and what its
purpose is.

I'm in favour of not writing a whole lot of basic documentation as
FAQs and standalone documents because the unstructured web of docs
created that way is much harder to comprehend (getting lost in the
web) and also a pain to maintain in the long run.

--
Ferdinand Soethe


Mime
View raw message