Are Fedora docs readable?

[Karsten Wade]

On Tue, 2005-05-10 at 07:29 -0400, Paul W. Frields wrote:
> On Tue, 2005-05-10 at 11:53 +0100, Timothy Murphy wrote:
> > Thomas Jones wrote:
> > 
> > >>I was looking for a document that would explain
> > >>how Linux/Fedora decides what driver to use
> > >>with a given USB device,
> > >>and google directed me to usb-hotplug-tutorial.
> > >>
> > >>Unfortunately this appeared to be in XML,
> > >>and required a DTD which I could not find.
> 
> I think we should consider requiring documentation to include a
> prominent link in the DTD comments that points people to a "how to build
> this document" spot on f.r.c.  Anyone care to comment?

We might want to make it a part of the template for the standard
introduction/about this document section.  Putting it in the XML would
be a nice thing to do, too.

We can also put a link to the canonical location in the Documentation
Guide.  This would appear in the legalnotice-*.xml alongside the URL to
the GFDL.

- Karsten
-- 
Karsten Wade, RHCE * Sr. Tech Writer * http://people.redhat.com/kwade/
gpg fingerprint:  2680 DBFD D968 3141 0115    5F1B D992 0E06 AD0E 0C41   
                       Red Hat SELinux Guide
http://www.redhat.com/docs/manuals/enterprise/RHEL-4-Manual/selinux-guide/
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
Url : http://lists.fedoraproject.org/pipermail/docs/attachments/20050510/8a499f0c/attachment.bin