On Tue, 2006-01-31 at 10:30 -0600, Eric Rostetter wrote: > Quoting Debra Deutsch <fedoradocs@xxxxxxxxxxxx>: > > > I've read the pages about writing using the wiki and wiki editing. It's > > left me with the impression that perhaps the FAQ should be broken into > > pages instead of being one long page. > > All the sites I've done, I've always generated the FAQ as both a single > monolithic FAQ and a paged version. Let the user pick which they want. This can be done by following a format similar to http://fedoraproject.org/wiki/Docs/Beats but using a [[Table of Contents]] at the start instead of the hand-generated list of links to the actual sub-pages. > Most users want a monolithic version for printing, handouts, etc. > Most users like to be able to go to a specific page in the docs easily > when searching for quick information (ala google, etc). Breaking this up could make for easier and more intuitive deep linking: http://fedoraproject.org/wiki/FAQ/GettingStarted#Is-my-hardware-compatible-with-Fedora Right now a link to that same question looks like this: http://fedoraproject.org/wiki/FAQ#head-640c24d1609de5de1e7955fc46743cc017e77d75 This format sucks for Google, because it changes all the time. You could simulate that with the anchors, but it would look more like this: http://fedoraproject.org/wiki/FAQ#GettingStarted--Is-my-hardware-compatible-with-Fedora - Karsten -- Karsten Wade, RHCE * Sr. Tech Writer * http://people.redhat.com/kwade/ gpg fingerprint: 2680 DBFD D968 3141 0115 5F1B D992 0E06 AD0E 0C41 Content Services Fedora Documentation Project http://www.redhat.com/docs http://fedoraproject.org/wiki/DocsProject
Attachment:
signature.asc
Description: This is a digitally signed message part
-- fedora-docs-list@xxxxxxxxxx To unsubscribe: https://www.redhat.com/mailman/listinfo/fedora-docs-list