Hi, Javier [Sorry, I CCed many mailing list. I only read -www and -doc. Please someone tell me where I should go.]
On Thu, May 16, 2002 at 12:11:30PM +0200, Javier Fernandez-Sanguino Pena wrote: > Package: www.debian.org > Version: N/A; reported 2002-05-16 > Severity: important > > (didn't now where to send this to, we should have a virtual 'debian-ddp' > or 'documentation' package to send the DDP stuff to). How about debian-policy. Or realistically, debian-doc and debian-i18n, etc. > Ok. The current DDP policy is way out of date, this has as a consequence > that there are a number of discrepancies in the published documentation on > how to handle, for example, internationalization extensions. > > Some issues that need to be tackled in policy which are currently not there: > > - use of CVS in the DDP documentation (this is a must and many documentation > does not follow it) Maybe we should file wishlist bug to the packages who do not use CVS. So maintainer will at least commit to DDP CVS. > - how must packages be prepared: one package per document? one for each > translated version? Input from i18n folks and solid best practice example is highly desirable. This needs to be discussed and demonstrated. > - layout of documentation in ftp.debian.org/debian/doc (we are not currently > publishing > there since it's done with 'byhand' targets in the packages), we need to > remove the byhand targets to properly "control" that section and tell > authors how to publish there By hand is absurd. It is too much work. > - formats (other than HTML) that the document must compile to in order for > it to be published. It was technically difficult in potato since pdf and ps sometimes did not build in non-English environment. But with woody version of debiandoc-sgml, it should publish html, text, pdf, and ps. Current practice of SGML.tar shall be depreciated. It shall be CVS or source deb file. Makefile need to be standardized (at least target names and way to specify language). > - where to send bugs related to documentation (to the package? to the > www site?) Good point. All DDP page shall indicate where. If CVS only, debian-doc. If packaged, normal package BTS location. For translated package, translator also needs informed. > - procedure of inclusion of documents in the DDP CVS server (what to edit, > what to add and what to change) (not really policy but should be added) Best practice guide. > I have a draft of proposal to remove the current policy and add a new one > which should close this bug. Will post more info when it's complete. Please post URL and discuss on debian-doc. As seen on debian-doc mailing list thread, the maintainer seems to be MIA. > PS: Most of this information is under 'issues' and 'ideas' in the > www.debian.org/ddp pages but it's been a long time and the current policy http://www.debian.org/doc/ddp to be precise :) > has not changed for a long time. Reading policy there which I found link first time, Filesystem: /usr/share/doc/manuals/somemanual/index.html /usr/share/doc/manuals/somemanual.ps.gz (optional) WWW server: http://www.debian.org/doc/manuals/somemanual/ FTP server: ftp://ftp.debian.org/debian/doc/manuals/somemanual.html.tar.gz ftp://ftp.debian.org/debian/doc/manuals/somemanual.text.gz ftp://ftp.debian.org/debian/doc/manuals/somemanual.dvi.gz ftp://ftp.debian.org/debian/doc/manuals/somemanual.ps.gz ftp://ftp.debian.org/debian/doc/manuals/somemanual.sgml.tar.gz I wonder how can this be so inconsistent with the reality. If we make updated ddp manual policy, it should be in more obvious location. -- ~\^o^/~~~ ~\^.^/~~~ ~\^*^/~~~ ~\^_^/~~~ ~\^+^/~~~ ~\^:^/~~~ ~\^v^/~~~ +++++ Osamu Aoki @ Cupertino CA USA See "Debian reference": http://www.debian.org/doc/manuals/reference/ See "User's Guide": http://www.debian.org/doc/manuals/users-guide/ "Debian reference" Project at: http://qref.sf.net I welcome your constructive criticisms and corrections. -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
