On Tue, Feb 3, 2009 at 6:37 AM, Thorsten Leemhuis <fedora@xxxxxxxxxxxxx> wrote: > > > On 03.02.2009 00:54, Kevin Fenzi wrote: >> >> On Mon, 2 Feb 2009 11:10:17 +1000 >> ryan lerch <ryanlerch@xxxxxxxxx> wrote: >> >>> Over at fedora-docs, there is ongoing discussion on the scope of the >>> release notes. At present, the release notes have evolved from a >>> document containing the relevant new features and important bug-fixes >>> into a document containing those items as well as an assortment of >>> extra basic documentation and howtos. For example, take the "Live >>> Image" section in the f10 notes [1], this is basically a brief >>> overview on Live Images (which were not a new feature in f10.) >>> >>> The fedora-docs project would like to get the input from the >>> developers on the release notes. Should we restrict the release notes >>> to being a document of the new and exciting features in the newest >>> release, and move the older, not so fresh documentation into the >>> relevant guides (such as the install guide)? >>> >>> Any other suggestions on the possible scope and direction of the >>> release notes are appreciated also! >> >> Yeah, I would like to see the release notes be smaller and just contain >> new information for the release. You could easily have a pointer to the >> install guide or other docs that contain more verbose info or info >> thats repeated every release. > > +1 ; some more thoughts on this: > http://thorstenl.blogspot.com/2008/12/read-same-paragraphs-every-half-year.html +1 Release Notes are not a place for random docs, it should just tell the reader about changes/new features. Just add links to related docs if necessary. -- fedora-devel-list mailing list fedora-devel-list@xxxxxxxxxx https://www.redhat.com/mailman/listinfo/fedora-devel-list
