|
From: Paul N. <pn...@ut...> - 2004-10-27 17:32:07
|
On Wed, 27 Oct 2004, Charles McColm wrote: > 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 Maybe this would work, but the old manuals will disappear soon (as soon as they are replaced by the docbook versions). I don't care too much, provided that the overall structure stays sane. Unfortunately I have to look at the directory structure on our server on Friday -- I may be changing things around then (because CVS doesn't handle symlinks). > > 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. Keep in mind two things: - The current manuals are not building (and won't until I fix the scripts) - The manual sources are on Sourceforge already (as part of the 0.6 release, I think). > > 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. Could you put all of these aliases into one file which other books could include? I don't care too much which tags are used so long as I know what they are. > > 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. I will add a "this could take a long time" message. - Paul |