Release Notes Draft

[John J. McDonough]

The wiki has been converted and a draft of the release notes is
available at

http://jjmcd.fedorapeople.org/Download/Release_Notes/

for your review.  The sources are up to date in git, but the translation
branch is not yet complete.  I will go ahead and do that this afternoon.

If you could review your beat promptly that would be a help.  This
evening we are due to send the first POTs to L10N and we should
stabilize them by tomorrow, so any edits should be made promptly.

A number of beats were blank, and some of them probably should be, but I
left them in the document for now as a reminder in case you are aware of
something that is missing.  I will get rid of them tomorrow.

Beginning tonight I will start the nightly build, and all the languages,
initially partially or not at all translated, will begin appearing in

http://fedorapeople.org/groups/docs/release-notes/

Thank you all for your hard work!

--McD

[Matthew Miller]

On Mon, Sep 06, 2010 at 11:45:53AM -0400, John J. McDonough wrote:
>  A number of beats were blank, and some of them probably should be,
> but I
>  left them in the document for now as a reminder in case you are aware of
>  something that is missing.  I will get rid of them tomorrow. 
Systemd needs more explaining, if we want that transition to go smoothly.
And it should be in the index under "init" as well as systemd. And also, it
should not go under "Boot" -- it is a system which manages processes on the
system from startup to shutdown.



-- 
Matthew Miller <mattdm(a)mattdm.org&gt;
Senior Systems Architect -- Instructional & Research Computing Services
Harvard School of Engineering & Applied Sciences

[John J. McDonough]

On Tue, 2010-09-07 at 00:14 -0400, Matthew Miller wrote:
>  On Mon, Sep 06, 2010 at 11:45:53AM -0400, John J. McDonough wrote:
>  > A number of beats were blank, and some of them probably should be, but I
>  > left them in the document for now as a reminder in case you are aware of
>  > something that is missing.  I will get rid of them tomorrow.
>  
>  Systemd needs more explaining, if we want that transition to go smoothly.
>  And it should be in the index under "init" as well as systemd. And also, it
>  should not go under "Boot" -- it is a system which manages processes on the
>  system from startup to shutdown. 
Certainly we would welcome more detail.  You should feel free to provide
it on the wiki.

https://fedoraproject.org/wiki/Docs/Beats/Boot

I'm less sure about moving it.  Since there were no other significant
changes to System Daemons perhaps it could go there and not get lost,
but I suspect system admins would need to make lots of changes to their
init scripts and I would think the first place they would look would be
Boot.

I would dearly love to give admins some help on what they need to do to
restore their configurations after this update, but I can't do it
without help, probably a lot of help, from development.

Since the XML conversion is now complete there is no longer a need to
maintain the beta wiki freeze, so if you can possibly contribute, please
do.  The longer you wait, though, the more of a problem it creates for
L10N.  But I do think it is important.

--McD

[Matthew Miller]

On Tue, Sep 07, 2010 at 09:01:40AM -0400, John J. McDonough wrote:
>  Certainly we would welcome more detail.  You should feel free to
> provide
>  it on the wiki.
>  https://fedoraproject.org/wiki/Docs/Beats/Boot 
*nod*

>  I'm less sure about moving it.  Since there were no other
> significant
>  changes to System Daemons perhaps it could go there and not get lost,
>  but I suspect system admins would need to make lots of changes to their
>  init scripts and I would think the first place they would look would be
>  Boot. 
Can we cross-reference things? It's reasonable to look for it there.

-- 
Matthew Miller           mattdm(a)mattdm.org          <http://mattdm.org/>

[Paul W. Frields]

On Tue, Sep 07, 2010 at 12:14:17AM -0400, Matthew Miller wrote:
>  On Mon, Sep 06, 2010 at 11:45:53AM -0400, John J. McDonough wrote:
>  > A number of beats were blank, and some of them probably should be, but I
>  > left them in the document for now as a reminder in case you are aware of
>  > something that is missing.  I will get rid of them tomorrow.
>  
>  Systemd needs more explaining, if we want that transition to go smoothly.
>  And it should be in the index under "init" as well as systemd. And also, it
>  should not go under "Boot" -- it is a system which manages processes on the
>  system from startup to shutdown. 
To Docs list -- is there any new material in the Deployment Guide
about using systemd?  There is some helpful documentation online at
the systemd upstream here:

http://www.freedesktop.org/wiki/Software/systemd

(Look for "Manual Pages And Documentation" somewhat down the list a
bit.)  At a minimum, we probably need to cover:

* How to change the default boot target
* How to enable/disable and start/stop services
* How to list what services are running now and what they're doing

It looks like these are covered in the man pages, FAQ, and tips &
tricks there, but any coverage of /sbin/chkconfig and /sbin/service
will probably need updating.  Note that there is still a chance that
systemd maybe deferred to F15 -- so this work is probably best done in
a branch and merged for the appropriate release.

-- 
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/
          Where open source multiplies: http://opensource.com

[Ruediger Landmann]

  On 09/07/2010 11:20 PM, Paul W. Frields wrote:
>  To Docs list -- is there any new material in the Deployment Guide
>  about using systemd? 
Not yet -- Silas is currently reviewing the DG to find any
places that 
will be affected.

Cheers
Rudi

Important! Publican bug -- please read (was: Release Notes Draft)

[Ruediger Landmann]

  On 09/07/2010 01:45 AM, John J. McDonough wrote:
>  The wiki has been converted and a draft of the release notes is
>  available at
>
>  http://jjmcd.fedorapeople.org/Download/Release_Notes/
>
>  for your review.  The sources are up to date in git, but the translation
>  branch is not yet complete.  I will go ahead and do that this afternoon.
>
>  If you could review your beat promptly that would be a help.  This
>  evening we are due to send the first POTs to L10N and we should
>  stabilize them by tomorrow, so any edits should be made promptly. 
Hi John -- unfortunately, the PO files are affected by a bug in 
Publican.[0]

Can you please regenerate the POT and PO files with the version of 
Publican on my Fedorapeople page,[1] or build it yourself from source.[2]

This same bug will affect anyone generating POT or PO files from the 
version of Publican (2.1) currently in the Fedora repos :(

Translators: if you encounter PO files that contain fuzzy strings where 
the msgid (English) contains the entities " or ' please alert 
the docs team. The effect of this particular bug is to change any 
apostrophes or single quote marks in the document into "'" and any 
double quote marks into """

This problem has been fixed in the Publican source; we hope to release a 
new version of the tool within the next few weeks. In the meantime, the 
existing version works fine for everything except generating or updating 
POT or PO files.

Cheers

Rudi


[0] https://bugzilla.redhat.com/show_bug.cgi?id=628266

[1] 
http://rlandmann.fedorapeople.org/publican/publican-2.1-0.fc13.t37.noarch...

[2] http://svn.fedorahosted.org/svn/publican/trunk/publican/

Important! Publican bug -- please read (was: Release Notes Draft)

[Eric Christensen]

On Tue, Sep 7, 2010 at 01:21, Ruediger Landmann <r.landmann(a)redhat.com&gt; wrote:
>  Hi John -- unfortunately, the PO files are affected by a bug in
>  Publican.[0]
>
>  Can you please regenerate the POT and PO files with the version of
>  Publican on my Fedorapeople page,[1] or build it yourself from source.[2] 
When will the repo version be updated?

--Eric

Important! Publican bug -- please read (was: Release Notes Draft)

[John J. McDonough]

On Tue, 2010-09-07 at 15:21 +1000, Ruediger Landmann wrote:
>  On 09/07/2010 01:45 AM, John J. McDonough wrote:
>  > The wiki has been converted and a draft of the release notes is
>  > available at
>  >
>  > http://jjmcd.fedorapeople.org/Download/Release_Notes/
>  >
>  > for your review.  The sources are up to date in git, but the translation
>  > branch is not yet complete.  I will go ahead and do that this afternoon.
>  >
>  > If you could review your beat promptly that would be a help.  This
>  > evening we are due to send the first POTs to L10N and we should
>  > stabilize them by tomorrow, so any edits should be made promptly.
>  
>  Hi John -- unfortunately, the PO files are affected by a bug in 
>  Publican.[0]
>  
>  Can you please regenerate the POT and PO files with the version of 
>  Publican on my Fedorapeople page,[1] or build it yourself from source.[2] 
done

--McD

[Christopher Antila]

Hi John:

I made changes to (i.e. "finally completed") the KDE portion of the
wiki's "Desktop" beat a few days ago, and they are not in the draft.  I
will add these to the git version today/tonight.  If there's anything
that I need to know before doing this - like things that I need to do
aside from downloading the repo, changing the file, then committing my
changes, please let me know.


Christopher.

On 06/09/2010 11:45:53 -0400, John J. McDonough wrote:
>  The wiki has been converted and a draft of the release notes is
>  available at
>  
>  http://jjmcd.fedorapeople.org/Download/Release_Notes/
>  
>  for your review.  The sources are up to date in git, but the translation
>  branch is not yet complete.  I will go ahead and do that this afternoon.
>  
>  If you could review your beat promptly that would be a help.  This
>  evening we are due to send the first POTs to L10N and we should
>  stabilize them by tomorrow, so any edits should be made promptly.
>  
>  A number of beats were blank, and some of them probably should be, but I
>  left them in the document for now as a reminder in case you are aware of
>  something that is missing.  I will get rid of them tomorrow.
>  
>  Beginning tonight I will start the nightly build, and all the languages,
>  initially partially or not at all translated, will begin appearing in
>  
>  http://fedorapeople.org/groups/docs/release-notes/
>  
>  Thank you all for your hard work!
>  
>  --McD
>  
>  
>

[John J. McDonough]

On Tue, 2010-09-07 at 09:01 -0400, Christopher Antila wrote:
>  Hi John:
>  
>  I made changes to (i.e. "finally completed") the KDE portion of the
>  wiki's "Desktop" beat a few days ago, and they are not in the draft.  I
>  will add these to the git version today/tonight.  If there's anything
>  that I need to know before doing this - like things that I need to do
>  aside from downloading the repo, changing the file, then committing my
>  changes, please let me know. 
Of course you will want to build the en-US and make sure it builds
properly before committing the changes.

If you can get the changes committed before 0337Z, then they will show
up in the overnight POTs and draft build.

The POT update runs fairly quickly, so L10N should have those well
before 0400Z each day.  The draft build starts later and takes a while,
so the updated drafts on

http://fedorapeople.org/groups/docs/release-notes 

won't show up until shortly after 0930Z.

I've made some other suggested changes and restarted the draft build
manually, and the link at

http://jjmcd.fedorapeople.org/Download/Release_Notes/ 

is now just a symlink to the groups/docs copy.

--McD