Michal C(ihar( a écrit :
Hi
On Thu 14. 10. 2004 16:05, Marc Delisle wrote:
I think the doc *is* structured but too large. You mean it should be splitted in smaller documents? It could be done. They only thing I miss in smaller documents is the ability to search using my browser's facilities, in case a notion is covered in more than one document.
Yes, sorry, bad wording. It should be split to logical parts, so you should not need to look over all of them, first idea I get (I didn't even check if I mentioned all from current doc):
- installation and configuration
- known problems (part of current FAQ)
- tips (part of current FAQ)
- project information (FAQ 7, credits, ...)
Good idea.
Once in a while we discuss about this, also about the doc source format, the possible generation of one HTML file or many small, a formal way of translating the doc, etc.
Well is here anybody who has actively used docbook or something like that?
Not me sorry.
For the more urgent matter (the new Security section), do you want to do it, or do you want me to do it? (with your proposed text)
Marc