RFC: Fedora 11 FAQ

[Paul W. Frields]

On Fri, May 01, 2009 at 09:12:42PM +0530, Rahul Sundaram wrote:
> On 05/01/2009 08:56 PM, Adam Williamson wrote:
> > On Fri, 2009-05-01 at 15:05 +0530, Rahul Sundaram wrote:
> >> Hi,
> >>
> >> I have posted a draft of the Fedora 11 FAQ at
> >>
> >> https://fedoraproject.org/wiki/Fedora_11_FAQ
> >>
> >> Feel free to edit the wiki if you want to highlight anything else or
> >> drop me a mail and I will add them.
> > 
> > It's nicely written, but it seems like a bit of an awkward document in
> > conception - somewhere between Release Notes and Errata and a general
> > Fedora (not really Fedora 11) FAQ. Couldn't we somehow reconcile it with
> > some of the other release documentation to avoid duplication of effort?
> 
> In the past, such release specific FAQ's have often been very helpful in
> addressing the repeatedly asked questions. I can't anticipate the FAQ's
> so the initial seed information tends to be a bit more generic. I cross
> reference existing documentation such as release notes to avoid
> duplication where possible.

I see places where that's not done, the 'alsamixer' workaround among
them.  If you could look at the preview release notes and link to the
appropriate places (using "f11" instead of "f11preview" in the URL),
that would be good.  Documentation maintenance is much more difficult
if it has to be done in multiple places rather than through
incorporation by reference.

> I am not very happy with the current release notes structure and will be
> spending more effort for the next release to get it better match what I
> think is the right style.

The Docs team remains open to assistance and welcomes input.  I would
recommend you start helping with the ideation process now, since the
discussion has already started:

http://www.redhat.com/archives/fedora-docs-list/2009-May/msg00001.html

-- 
Paul W. Frields                                http://paul.frields.org/
  gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233  5906 ACDB C937 BD11 3717
  http://redhat.com/   -  -  -  -   http://pfrields.fedorapeople.org/
  irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug