[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Things to check in release notes



Justin B Rye wrote:
> Here's a second simple one: installing.dbk

Number three would be release-notes.dbk, but I don't see anything
there that needs fixing.

moreinfo.dbk has a couple of trivial glitches and one grammatical
mix-up that needs a bit of reorganising ("Documentation [...] are
available").
-- 
JBR	with qualifications in linguistics, experience as a Debian
	sysadmin, and probably no clue about this particular package
Index: moreinfo.dbk
===================================================================
--- moreinfo.dbk	(revision 9825)
+++ moreinfo.dbk	(working copy)
@@ -12,8 +12,8 @@
 Beyond these release notes and the installation guide, further documentation on
 &debian; is available from the Debian Documentation Project (DDP),
 whose goal is to create high-quality documentation for Debian users and
-developers.  Documentation, including the Debian Reference, Debian New
-Maintainers Guide, and Debian FAQ are available, and many more.  For full
+developers.  Available documentation includes the Debian Reference, Debian New
+Maintainers Guide, the Debian FAQ and many more.  For full
 details of the existing resources see the <ulink
 url="&url-ddp;">Debian Documentation website</ulink> and the
 <ulink url="&url-wiki;">Debian Wiki website</ulink>
@@ -31,7 +31,7 @@
 <para>
 There are many sources of help, advice and support for Debian users, but these
 should only be considered if research into documentation of the issue has
-exhausted all sources.  This section provides a short introduction into these
+exhausted all sources.  This section provides a short introduction to these sources
 which may be helpful for new Debian users.
 </para>
 <section id="lists">
@@ -49,7 +49,7 @@
 <section id="irc">
 <title>Internet Relay Chat</title>
 <para>
-Debian has an IRC channel dedicated to the support and aid of Debian users
+Debian has an IRC channel dedicated to the support and aid of Debian users,
 located on the OFTC IRC network.  To access the channel, point your favorite
 IRC client at irc.debian.org and join <literal>#debian</literal>.
 </para>
@@ -69,7 +69,7 @@
 <section id="bugs">
 <title>Reporting bugs</title>
 <para>
-We strive to make &debian; a high quality operating system, however
+We strive to make &debian; a high quality operating system; however
 that does not mean that the packages we provide are totally free of bugs.
 Consistent with Debian's <quote>open development</quote> philosophy and as a service to our
 users, we provide all the information on reported bugs at our own Bug Tracking

Reply to: