* Sec "Writing useful descriptions". Added a sentence about the

  capitalization of the first letter.

git-svn-id: svn://anonscm.debian.org/ddp/manuals/trunk/developers-reference@1717 313b444b-1b9f-4f58-a734-7bb04f332e8d

diff --git a/developers-reference.sgml b/developers-reference.sgml
index cb022f7a4ac4330e3b9c3201883ca9b8d2275b0c..bb0340cd7b1f68e6262d7cf7f68493e27de6ad43 100644 (file)
--- a/developers-reference.sgml
+++ b/developers-reference.sgml
@@ -6,7 +6,7 @@
   <!entity % commondata  SYSTEM "common.ent" > %commondata;
 
   <!-- CVS revision of this document -->
-  <!entity cvs-rev "$Revision: 1.112 $">
+  <!entity cvs-rev "$Revision: 1.113 $">
   <!-- if you are translating this document, please notate the CVS
        revision of the developers reference here -->
   <!--
@@ -2799,11 +2799,15 @@ web site if there's any. If the package is not yet considered stable
 by the author, you may also want to warn the user that the
 package is not ready for production use.
            <p>
+For consistency and for an aesthetic concern, you should capitalize the
+first letter of the description.
+           <p>
 Last but not least, since the first user impression is based on
 that description, you should be careful to avoid English
 mistakes. Ensure that you spell check it.
 <prgn>ispell</prgn> has a special option (<tt>-g</tt>) for that:
-<example>ispell -d american -g debian/control</example>
+<example>ispell -d american -g debian/control</example>.
+