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 -- fedora-devel-list mailing list fedora-devel-list@xxxxxxxxxx https://www.redhat.com/mailman/listinfo/fedora-devel-list
