On Mon, Feb 02, 2009 at 11:10:17AM +1000, ryan lerch 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! > You have to have a balance between verbosity and brevity because if a document is too long, someone will prolong reading it. Perhaps if the how-tos and helpful tips were all in a certain section, the release notes would not have this problem, and also have an added convenience of having even more helpful information. -- Ian Weller <ianweller@xxxxxxxxx> http://ianweller.org GnuPG fingerprint: E51E 0517 7A92 70A2 4226 B050 87ED 7C97 EFA8 4A36 "Technology is a word that describes something that doesn't work yet." ~ Douglas Adams
Attachment:
pgp9d7YEusSkG.pgp
Description: PGP signature
-- fedora-devel-list mailing list fedora-devel-list@xxxxxxxxxx https://www.redhat.com/mailman/listinfo/fedora-devel-list
