Hi, Sounds good. Haven't had the chance to look at it yet ... However one request if it is easy. Quite a few times people have commented that the documentation is difficult to navigate. The reason being that once you go "down" a documentation link it is impossible to get back out without using Back button.
What I would like is something at the top of each page listing current position. Something like Avalon > Phoenix > Developer Book > What is a Block? > BlockInfos So is this easy to implement ? On Thu, 19 Jul 2001 04:16, Berin Loritsch wrote: > The new documentation build process is now in place. If we have any > volunteers, We should probably go through and apply the > "document2docbook.xsl" stylesheet to all of our xdocs files. At that time, > there is only some minor documentation changes that will need to be > applied. > > The document files are translated into "Articles" because they infer a > self-contained document. > > Refinements to transformed docs include: > > * Creating "books" for all related documentation (e.g. history) > * Creating "Author" bios and referencing them (each person should > deal with their own Bio). > * Fine-tune markup to represent what we truly want. > > > Another thing is we should fine-tune the HTML rendering to better > handle new constructs (e.g. warning, note, blockquote). > > One really nice thing about the new build format is that the frame for the > site (site2xhtml.xsl) is merely an XHTML file with <xsl:copy-of/> > statements to include the generated menu and body content. > > There is one enhancement to Cocoon that needs to be done to really make > this nice, and that is using a file to include all the URIs to process. > That can be dynamically built from the book.xml files. ---------------------------------------- Content-Type: application/x-pkcs7-signature; charset="us-ascii"; name="smime.p7s" Content-Transfer-Encoding: base64 Content-Description: S/MIME Cryptographic Signature ---------------------------------------- -- Cheers, Pete *-----------------------------------------------------* | "Faced with the choice between changing one's mind, | | and proving that there is no need to do so - almost | | everyone gets busy on the proof." | | - John Kenneth Galbraith | *-----------------------------------------------------* --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
