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

Bug#608887: release-notes: Debian Documentation and Debian Wiki in Chapter 6



Package: release-notes
Severity: normal

In Chapter 6. More information on Debian GNU/Linux, I have few touch up
requests.

DDP was mentioned but its link is pointed to
 http://www.debian.org/doc/ddp (not the best page for us).

As I recall, DDP web pages were reorganized some time ago and this
particular page is more of historic place holder with half the page
talking "Problematic manuals".  We should use instead the following for
the entry point for the DDP and other key documentations:
 http://www.debian.org/doc/

Contributor of DDP should be more happy to see 
 http://www.debian.org/doc/cvs

In order to switch all translation in any state to be updated, I request
to change release-notes.ent content for url-ddp.  This is used twice in
the whole document and switching from .../doc/ddp to .../doc/ is better.

Also Debian Wiki has grown to be an important documentation resource for
the user which needs to be mentioned.  (although .../doc page mention it.)
(Since debian-www is used by Wiki people, I CC my bug report there.)

Since Debian Wiki is not just for DebianIRC, I wish its reference to be
tuned in the same chapter.

I summary, I propose attached patch.

-- System Information:
Debian Release: squeeze/sid
  APT prefers testing
  APT policy: (500, 'testing'), (1, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.32-5-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_US.utf8, LC_CTYPE=en_US.utf8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

diff -Nru release-notes.orig/en/moreinfo.dbk release-notes/en/moreinfo.dbk
--- release-notes.orig/en/moreinfo.dbk	2011-01-04 20:15:59.693577323 +0900
+++ release-notes/en/moreinfo.dbk	2011-01-04 21:05:40.580652217 +0900
@@ -15,7 +15,8 @@
 developers.  Documentation, including the Debian Reference, Debian New
 Maintainers Guide, and Debian FAQ are available, and many more.  For full
 details of the existing resources see the <ulink
-url="&url-ddp;">DDP website</ulink>.
+url="&url-ddp;">Debian Documentation website</ulink> and
+<ulink url="&url-wiki;">Debian Wiki website</ulink>
 </para>
 <para>
 Documentation for individual packages is installed into
@@ -55,7 +56,7 @@
 <para>
 Please follow the channel guidelines, respecting other users fully.  The
 guidelines are available at the <ulink
-url="&url-wiki;DebianIRC">Debian Wiki</ulink>.
+url="&url-wiki;DebianIRC">Debian Wiki: DebianIRC</ulink>.
 </para>
 <para>
 For more information on OFTC please visit the <ulink
@@ -104,9 +105,9 @@
 maintain Debian's high quality distribution, <ulink
 url="&url-bts;">submit bugs</ulink> and help developers track
 them down and fix them.  If you have a way with words then you may want to
-contribute more actively by helping to write <ulink
-url="&url-ddp;">documentation</ulink> or <ulink
-url="&url-debian-i18n;">translate</ulink> existing
+contribute more actively by helping to write 
+<ulink url="&url-ddp-svn-info;">documentation</ulink> or 
+<ulink url="&url-debian-i18n;">translate</ulink> existing
 documentation into your own language.
 </para>
 <para>
diff -Nru release-notes.orig/release-notes.ent release-notes/release-notes.ent
--- release-notes.orig/release-notes.ent	2010-11-26 02:14:05.371048811 +0900
+++ release-notes/release-notes.ent	2011-01-04 20:29:40.548585011 +0900
@@ -54,7 +54,7 @@
 <!ENTITY debian-irc-server "irc.debian.org">
 <!ENTITY url-ports "http://www.debian.org/ports/";>
 <!ENTITY url-wnpp "http://www.debian.org/devel/wnpp/";>
-<!ENTITY url-ddp "http://www.debian.org/doc/ddp";>
+<!ENTITY url-ddp "http://www.debian.org/doc/";>
 <!ENTITY url-debian-jr "http://www.debian.org/devel/debian-jr/";>
 <!ENTITY url-debian-med "http://www.debian.org/devel/debian-med/";>
 <!ENTITY url-apt-pin-howto "http://www.debian.org/doc/manuals/apt-howto/ch-apt-get";>

Reply to: