Fedora Release Notes

drago01 drago01 at gmail.com
Tue Feb 3 12:56:10 UTC 2009


On Tue, Feb 3, 2009 at 6:37 AM, Thorsten Leemhuis <fedora at leemhuis.info> wrote:
>
>
> On 03.02.2009 00:54, Kevin Fenzi wrote:
>>
>> On Mon, 2 Feb 2009 11:10:17 +1000
>> ryan lerch <ryanlerch at gmail.com> 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.




More information about the fedora-devel-list mailing list