[Syllable-developer] Re: The Future of AtheDocs

[Kaj de V. <syl...@fr...>]

If Brent wants to take on the work, I would prefer him being the editor. 
Syllable is about trying to extract an integrated system from a chaotic 
development process. To do that, we need a good level of editorial 
control, and that goes for the documentation as well.

Wiki formatting is indeed a point to be careful with. Ideally, 
community-generated documentation from the web site would flow into the 
core Syllable documentation system after a period of editing. To make this 
as painless as possible, the web site formatting options would have to 
comply with the schema we develop for the core documentation. Wiki markup 
is usually less structured than that, allowing arbitrary formatting. 
Instead, we need formatting that conveys only the structure of the text, 
not the eventual presentation.

Kaj

----- Message from William Hoggarth <w.h...@st...> on 
Thu, 30 Oct 2003 16:09:38 +0000 -----
To:
syl...@li...
Subject:
Re: [Syllable-developer] The Future of AtheDocs
I think I'd prefer the wiki approach, mainly because then you don't have 
to 
rely on one person to integrate comments or accept submissions. It would 
mean 
less workload for you! There has been a recent discussion about some kind 
of 
standard help system, probably implemented with XML. So it may not be 
worth 
having extra formatting as it will eventually have to be converted to XML 
anyway.

Whichever aproach is taken, I'm happy to contribute.

Will H