Feedback request

[Karsten Wade]

On Tue, 2006-01-31 at 10:30 -0600, Eric Rostetter wrote:
> Quoting Debra Deutsch <fedoradocs at 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-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
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL: <http://listman.redhat.com/archives/fedora-docs-list/attachments/20060201/a94cf7c6/attachment.sig>