|
From: Charles M. <ch...@po...> - 2004-10-27 14:08:56
|
On Monday 25 October 2004 5:49 pm, Paul Nijjar wrote: > Are you going to use the sourceforge servers for this? I want to > synchronize the directory structure for the entire project, so maybe we > should discuss what you will call this directory tree. We already have a > "manuals" directory -- maybe you could put the docbook admin guide in > > wclp/manuals/adminguide ? Or I could add a subdirectory: wclp/manuals/docbook/adminguide > This would wipe out our existing admin guide, but that should be > okay. Let's not wipe out the existing guide. We can always remove it later. There are still problems with the DocBook version. At some point we will have to come up with a guide to writing documentation with tips on what DocBook tags to use where. DocBook has hundreds of tags, finding the proper one can be a bit daunting. If we have a guide we'll ensure that documentation stays uniform among books. One of the nice things about DocBook is that we can books into sets of books. Uniformity would be critical for this. And content can be reusable. So, at the top level (Set) we could have something like &twc; stand for "The Working Centre." Every book below the set need only type &twc; instead of The Working Centre. > I can explain the partitioning part, but I don't know why the > This can be turned off if you wish. Maybe I will put a message > saying that the installer is checking for bad blocks, which will take a Keeping it on is probably a good idea until we start dealing with 10GB+ drives, but I wondered why it took so long - I imagine others would too - I was tempted to shut the machine off, someone with less patience might. |