- clarify wording between "porter upload", "binary-only NMU", "simple
recompile"; closes: #102626
- extended "removing a package"; closes: #135560
+ - Added best packaging practices chapter.
+ - Added "Writing useful descriptions" as a first entry in that
+ chapter. Closes: #53109, #129848
* Antoine Hulin:
- update French translation
<!entity % commondata SYSTEM "common.ent" > %commondata;
<!-- CVS revision of this document -->
- <!entity cvs-rev "$Revision: 1.97 $">
+ <!entity cvs-rev "$Revision: 1.98 $">
<!-- if you are translating this document, please notate the CVS
revision of the developers reference here -->
<!--
latest <package>lintian</package>.
+ <chapt id="best-pkging-practices">
+ <heading>Best Packaging Practices</heading>
+ <p>
+Debian's quality is largely due to its Policy that all packages
+follow. But it's also because we accumulated years of experience
+in packaging; very talented people created great tools to make
+good packages without much troubles.
+ <p>
+This chapter provides the best known solutions to common problems
+faced during packaging. It also lists various advice collected on
+several mailing lists. By following them, you will make Debian's quality
+even better.
+
+ <sect id="misc-advice">
+ <heading>Miscellaenous advice</heading>
+
+ <sect1 id="writing-desc">
+ <heading>Writing useful descriptions</heading>
+ <p>
+The description of the package (as defined by the corresponding field
+in the <file>control</file> file) is usually the first information
+available to the user before he installs it. As such, it should
+provide all the required information that can help him decide whether
+or not he will install it.
+ <p>
+For example, apart from the usual description that you will copy from the
+upstream <file>README</file>, you should include the URL of the
+website 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.
+
+
+
<chapt id="beyond-pkging">
<heading>Beyond Packaging</heading>
<p>