On Tue, 2006-01-31 at 10:30 -0600, Eric Rostetter wrote:
Quoting Debra Deutsch <fedoradocs(a)ddeutsch.org>:
> 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-compatibl...
Right now a link to that same question looks like this:
http://fedoraproject.org/wiki/FAQ#head-640c24d1609de5de1e7955fc46743cc017...
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-compatib...
- 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