Re: Are Fedora docs readable?

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Tue, 2005-05-10 at 11:06 -0500, Tommy Reynolds wrote:
> Uttered "Paul W. Frields" <stickster@xxxxxxxxx>, spake thus:
> 
> > 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?
> 
> Well, none of the source code I come across on the web has a "how to
> compile me" comment in the "main.c" file ;-)
> 
> If folks come in by the backdoor via a Google search, and the don't
> bother to move up a level in the URL if there's something they don't
> understand then is a comment somewhere going to help them?
> 
> The reason my reply to the OP was border-line snide was to suggest
> that the question was not answerable in its current form and that the
> OP needed to do a bit more homework.
> 
> I think this is really a non-problem.

You may be right.  My natural inclination -- and that of many others in
the FDP -- is to try and make life easier for someone who is having
difficulties, but there is a point beyond which the bar shouldn't be
lowered.  Otherwise we'd spend all our times fixing these kind of
problems.  Thanks for the reminder.

-- 
Paul W. Frields, RHCE                          http://paul.frields.org/
  gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233  5906 ACDB C937 BD11 3717
 Fedora Documentation Project: http://fedora.redhat.com/projects/docs/

Attachment: signature.asc
Description: This is a digitally signed message part

-- 

fedora-docs-list@xxxxxxxxxx
To unsubscribe: 
http://www.redhat.com/mailman/listinfo/fedora-docs-list

[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Red Hat 9]     [Yosemite News]     [KDE Users]

  Powered by Linux