Re: release notes: first draft

[Shaun McCance <shaunm gnome org>]

On Fri, 2006-03-10 at 12:32 -0800, Bob Kashani wrote:
> On Fri, 2006-03-10 at 14:05 -0600, Shaun McCance wrote:
> > On Mon, 2006-03-06 at 23:57 +0800, Davyd Madeley wrote:
> > > Ok guys and gals. I am announcing a preliminary draft of the release
> > > notes for 2.14. We now require proof readers for spelling, grammar and
> > > technical correctness.
> > > 
> > > The latest committed version is online at:
> > >     http://www.gnome.org/start/2.14/notes/C/index.html
> > > 
> > > You can also check out the release notes from CVS:
> > > http://cvs.gnome.org/viewcvs/gnomeweb-wml/www.gnome.org/start/2.14/notes/docbook/C/
> > > 
> > > We are using gnome-doc-utils for translation. I hope the translators
> > > know how to get all of that working, because I have no idea.
> > > 
> > > Warning, I AM AN AUSTRALIAN, SPELLINGS MAY BE CONSIDERED INCORRECT. My
> > > grammar is also pretty appalling. Please send through corrections for
> > > these. Feel free to correct minor spelling mistakes yourself.
> > > 
> > > Discussion should happen on list as appropriate or on the IRC channel
> > > #release-notes on irc.gnome.org.
> > 
> > Way later than I'd hoped to provide this, but I've
> > attached a diff with some small changes.  This is
> > strictly copy editing; I didn't touch content.
> > 
> > Basically, the diff says this:
> 
> Seems you forgot to add the diff, Shaun...

Well that was silly of me.

--
Shaun

? rnotes-shaunm.diff
Index: rnadmins.xml
===================================================================
RCS file: /cvs/gnome/gnomeweb-wml/www.gnome.org/start/2.14/notes/docbook/C/rnadmins.xml,v
retrieving revision 1.11
diff -u -r1.11 rnadmins.xml
--- rnadmins.xml	10 Mar 2006 05:01:38 -0000	1.11
+++ rnadmins.xml	10 Mar 2006 19:54:35 -0000
@@ -52,7 +52,7 @@
 		<para>
 			Users or groups (???) are placed into profiles which will be used when
 			they log into their GNOME session. This allows an administrator to easily
-			create multiple profiles and allocate each user separately. Which allows
+			create multiple profiles and allocate each user separately, which allows
 			users to have different setups based on their job description (e.g. receptionist, data
 			entry clerk, programmer, human resources manager, etc.).
 		</para>
@@ -93,7 +93,7 @@
 				Command-line access
 			</para></listitem>
 			<listitem><para>
-				The ability to shutdown or reboot the machine
+				The ability to shut down or reboot the machine
 			</para></listitem>
 			<listitem><para>
 				Access to specific protocols in the web browser
Index: rndevelopers.xml
===================================================================
RCS file: /cvs/gnome/gnomeweb-wml/www.gnome.org/start/2.14/notes/docbook/C/rndevelopers.xml,v
retrieving revision 1.11
diff -u -r1.11 rndevelopers.xml
--- rndevelopers.xml	10 Mar 2006 05:11:44 -0000	1.11
+++ rndevelopers.xml	10 Mar 2006 19:54:35 -0000
@@ -10,8 +10,8 @@
 	<para>
 		The GNOME 2.14 Developers' Platform provides a stable base for independent
 		software developers to create third-party applications. GNOME and its
-		platform are licensed to allow the creation of both Free and Proprietary
-		Software to run on top of GNOME.
+		platform are licensed to allow the creation of both free and proprietary
+		software to run on top of GNOME.
 	</para>
 
 	<para>
@@ -27,7 +27,7 @@
 			As of GLib 2.10,
 			the GSlice allocator replaces the older GMemChunk and GTrashStacks APIs
 			available in GLib. GSlice is very similar to the kernel slab allocator and
-			allows for fast, memory efficient allocation of small structures (e.g.
+			allows for fast, memory-efficient allocation of small structures (e.g.
 			GList
 			elements, GtkWindow structures). GSlice also has none of the locking
 			overhead of GMemChunk, which makes it much faster in multithreaded
@@ -96,7 +96,7 @@
 				in this way.
 			</para></listitem>
 			<listitem><para>
-				Session managed applications will not be handled cleanly, ensure that
+				Session managed applications will not be handled cleanly, so ensure that
 				you pass the <option>--sm-disable</option> flag on your
 				<option>Exec</option> line.
 			</para></listitem>
Index: rngettinginvolved.xml
===================================================================
RCS file: /cvs/gnome/gnomeweb-wml/www.gnome.org/start/2.14/notes/docbook/C/rngettinginvolved.xml,v
retrieving revision 1.7
diff -u -r1.7 rngettinginvolved.xml
--- rngettinginvolved.xml	10 Mar 2006 05:08:44 -0000	1.7
+++ rngettinginvolved.xml	10 Mar 2006 19:54:35 -0000
@@ -8,11 +8,11 @@
 	<title>Getting Involved</title>
 
 	<para>
-		Helping GNOME is a rewarding, satisfying and positive experience. You will
+		Helping GNOME is a rewarding, satisfying, and positive experience. You will
 		join with hundreds of dedicated enthusiasts from all walks of life and all
 		places on the globe. Skilled and motivated contributors to GNOME may find
 		new doors and opportunities open for them in the form of recognition,
-		speaking appearances and gainful employment.
+		speaking appearances, and gainful employment.
 	</para>
 	
 	<para>
Index: rnusers.xml
===================================================================
RCS file: /cvs/gnome/gnomeweb-wml/www.gnome.org/start/2.14/notes/docbook/C/rnusers.xml,v
retrieving revision 1.27
diff -u -r1.27 rnusers.xml
--- rnusers.xml	10 Mar 2006 16:49:20 -0000	1.27
+++ rnusers.xml	10 Mar 2006 19:54:35 -0000
@@ -9,7 +9,7 @@
 	
 	<para>
 			The GNOME Project's focus on users and usability continues in GNOME 2.14
-			with it's hundreds of bug fixes and user-requested improvements. But the
+			with its hundreds of bug fixes and user-requested improvements. But the
 			shear number of enhancements make it impossible to list every change and
 			improvement that have been made. This page hopes to highlight some of the
 			more exciting user-oriented features in this release of GNOME.
@@ -22,7 +22,7 @@
 			Just as you would tune your car, our skilled engineers have strived
 			to tune many parts of GNOME to be as fast as possible. Several important
 			components of the GNOME desktop are now measurably faster, including
-			text rendering, memory allocation and numerous individual applications.
+			text rendering, memory allocation, and numerous individual applications.
 			Faster font rendering and memory allocation benefit all GNOME and
 			GTK+ based applications without the need for recompilation.
 		</para>
@@ -141,7 +141,7 @@
 			</mediaobject>
 		</figure>
 		<para>
-			Like with the file browser, users who have the Beagle search framework
+			Like with the file manager, users who have the Beagle search framework
 			available will be able to utilize it for even faster and more accurate
 			searching.
 		</para>
@@ -151,10 +151,10 @@
 		<title>Ekiga</title>
 
 		<para>
-			Ekiga, formerly known as GNOME Meeting is GNOME's voice and video-over-IP
+			Ekiga, formerly known as GNOME Meeting, is GNOME's voice and video-over-IP
 			client. Ekiga supports both the SIP and H323 protocols.
 			SIP, a popular protocol used in Google Talk,
-			Asterisk and many other software and hardware VoIP devices, is a recent
+			Asterisk, and many other software and hardware VoIP devices, is a recent
 			addition to Ekiga. H323 is an
 			older communications protocol, used in Microsoft Netmeeting and some
 			telecommunications hardware.
@@ -195,6 +195,7 @@
 		<title>Improved Window Management</title>
 
 		<para>
+		  <!-- Doesn't it use resistance, rather than magnetism? -->
 			Several new features have been added to Metacity to improve window
 			management. Window edges now have a magnetic attraction, making it
 			possible to "click" windows together. Multiple monitor (head) handling has
@@ -403,10 +404,10 @@
 		</figure>
 
 		<para>
-			Also new, is the ability to write plugins for Gedit in Python. This allows
+			Also new is the ability to write plugins for Gedit in Python. This allows
 			the functionality of Gedit to be extended and customized easily, even if
 			you're not a strong programmer. Some useful plugins that come with Gedit
-			include one to execute external commands, support for tag-based completion
+			include one to execute external commands, support for tag-based completion,
 			and an interactive Python console.
 		</para>
 		
@@ -440,7 +441,7 @@
 			unlock screen dialog are now translatable into native languages and
 			accessible to users with disabilities. These accessibility enhancements
 			allow users with disabilities to easily unlock their displays and are part
-			of the on going accessibility improvements being made to the entire GNOME
+			of the ongoing accessibility improvements being made to the entire GNOME
 			Desktop.
 		</para>
 
@@ -481,13 +482,13 @@
 
 		<para>
 			All of the multimedia applications that ship with GNOME have been upgraded
-			to take advantage of the latest GStreamer; including Totem, Sound Juicer
+			to take advantage of the latest GStreamer; including Totem, Sound Juicer,
 			and Volume Control.
 		</para>
 
 		<para>
 			GStreamer 0.10 will also allow users to take advantage of multimedia
-			plugins distributed by 3rd party vendors. This will allow vendors to
+			plugins distributed by third-party vendors. This will allow vendors to
 			offer support for licensed codecs where a free codec is not available
 			or distributable (for legal reasons). These may include support
 			for AC3, WMA, MP3 and more. A licensed, yet freely available MP3 plugin
@@ -526,7 +527,7 @@
 		<figure id="rnusers-figure-control-center-sound">
 			<title>
 				Select from a list of available sounds or select your own file from the
-				filesystem, then choose your default sound card.
+				file system, then choose your default sound card.
 			</title>
 			<mediaobject>
 				<imageobject>