On Wed, 2004-09-15 at 15:12, Paul W. Frields wrote: > I see your point, Tammy, but my feeling would be to opt for only two (or > three) subheadings under the current "Docs" nav bar entry: > > Docs > by Title > by FC Release > [FAQ]* > > *This would be that extra structure I mentioned; not really a FAQ, but > an organization of questions that would link to the Title index. I.e., "by Title" expands to have a list of all documents by title in alpha order, and "by FC Release" expands to a short list of release numbers, which then expand to a set of document titles that are just part of that release? One immediate problem I see is a maintenance nightmare. As much as we would like to have a CMS, this is currently a manual process. We need to focus on a simple structure that works, and let Google do the indexing for us. :) > With the very aggressive release schedule of Fedora Core, it wouldn't be > long before the nav bar became very crowded (FC2 through FC6, anyone?). > The Docs Project doesn't currently have a policy for when we won't > publish documentation anymore for a release, and I'm not sure we should > have one. There may be people as comfortable staying with certain > releases as they were staying with, say, Red Hat Linux 7.3. I would try > and leave the nav bar as generic as possible while still being useful. It seems reasonable to hand-off maintenance on version-specific docs to the Fedora Legacy project, when the matching version of FC is handed-off. An author could choose to continue to work on the document, but it is now under the aegis of the Legacy group, who are presumably just following the examples and rules we have set. Just like supporting the software, we have to draw the line on how far back this project is going to support documents. We don't have the resources to support a version of FC for several years. Tying the lifecycle of our documents into the entire distro lifecycle seems like a good idea. Just my personal pennies, - Karsten -- Karsten Wade, RHCE, Tech Writer a lemon is just a melon in disguise http://people.redhat.com/kwade/ gpg fingerprint: 2680 DBFD D968 3141 0115 5F1B D992 0E06 AD0E 0C41
