Confusion updating release notes

[Karsten Wade]

On Fri, Feb 13, 2009 at 10:39:53PM -0500, Christopher Beland wrote:
> We've made some changes directly to the Alpha release notes on the wiki,
> which is not what the Process page says to do, but it's unclear it's
> being followed.  I just wanted to make sure our changes aren't lost, and
> to find someone who can authoritatively update the Process page or tell
> people they should be following it more closely.  8)

That is fine.  We use the Alpha notes to make the Beta notes, then the
content is rolled in to the final release notes.  Sometimes it's
better ot use the common bugs page, or at least to make sure there is
a cross-reference from the wiki-based notes to the common bugs when
there are common bugs.

You are correct, our process content is out of date and inconsistent.
I'm Cc:'ing the Docs Project list so that others working on these
processes can help get them updated.  Thanks for trying to do things
the right way!

- Karsten


> Thanks,
> 
> Beland
> 
> -------- Forwarded Message --------
> > From: Matthias Clasen <mclasen at redhat.com>
> > Reply-To: For testers of Fedora Core development releases
> > <fedora-test-list at redhat.com>
> > To: For testers of Fedora Core development releases
> > <fedora-test-list at redhat.com>
> > Subject: Re: Ctrl-Alt-Backspace change
> > Date: Mon, 09 Feb 2009 10:53:59 -0500
> > 
> > On Mon, 2009-02-09 at 03:03 -0500, Christopher Beland wrote:
> > > Some people on this list have requested additional information about
> > > this change be added to the release notes, but I'm not sure how to do
> > > this.  This page is supposed to explain the process of producing
> > > release notes:
> > > 
> > > https://fedoraproject.org/wiki/DocsProject/ReleaseNotes/Process
> > > 
> > > The confusing part is that I cannot find any links that page or
> > > anywhere under https://fedoraproject.org/wiki/DocsProject to the
> > > Fedora 11 Alpha Release Notes
> > > (https://fedoraproject.org/wiki/Fedora_11_Alpha_release_notes, found
> > > with Google).  Should the notes be linked in, or are Rawhide notes
> > > intentionally hidden?
> > > 
> > > The process page says that the Alpha release notes are supposed to
> > > have a link to https://fedoraproject.org/wiki/Documentation_Beats
> > > soliciting contributions, but there is no such link.
> > > 
> > > Most importantly, it's also very unclear where to update content at
> > > the moment.  If you edit the Alpha release notes directly, will this
> > > change make it into the final release notes?  The process page seems
> > > to imply that release notes simply summarize or are pulled from the
> > > Beats page, but there isn't any information in the Xorg beat about
> > > this change (and I don't think there ever has been).
> > 
> > That is because, just like you, I couldn't really figure out the process
> > I was expected to follow, and just added the section to the alpha
> > release notes directly.
> > 
> > > <<
> > > 
> > > If /etc/X11/xorg.conf does not exist, create it by running this command
> > > as root:
> > > 
> > >  Xorg -configure
> > > 
> > > The Xorg project has changed the default DontZap setting to "true"
> > > after complaints from desktop users that accidentally hit
> > > Ctrl+Alt+Backspace when trying to type Alt+Backspace, Ctrl+Backspace,
> > > or Shift+Backspace, or who had StickyKeys enabled.  Ctrl+Alt+Backspace
> > > is also a keyboard shortcut for deleting certain expressions in C and
> > > Java modes in Emacs.
> > > 
> > > <<
> > > 
> > > Is that correct?
> > 
> > Sounds very good to me.
> > 
> 

-- 
Karsten 'quaid' Wade, Community Gardener
http://quaid.fedorapeople.org
AD0E0C41
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
Url : http://lists.fedoraproject.org/pipermail/docs/attachments/20090216/16bd2c73/attachment.bin