Bug#106492: marked as done (www.debian.org: Find semi-automated way to provide doc-debian-NN info)
Your message dated Sat, 07 Apr 2012 22:00:22 -0400
with message-id <4F80F136.email@example.com>
and subject line Re: www.debian.org: Find semi-automated way to provide doc-debian-NN info
has caused the Debian Bug report #106492,
regarding www.debian.org: Find semi-automated way to provide doc-debian-NN info
to be marked as done.
This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.
(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact firstname.lastname@example.org
Debian Bug Tracking System
Contact email@example.com with problems
--- Begin Message ---
We currently have the same info in the www archive as in the FTP archive
and some packages (doc-debian for example). We should find a way to provide
information common to some packages (doc-debian and doc-debian-es, for example
I just submitted a bug to the latest one) in a semi-automatic way.
Common information includes:
- bug refcards
- information on bug access and reporting
- mailing list information
- social contract
- FAQ (although this is part of the DDP and currently the Spanish FAQ is not in the CVS).
We should have a way to handle fixes to this information that do not require
hand editing (as I just did for doc-debian-es) and enables us to have
doc-debian-XXX (XXX any lang) available as soon as this items are translated and
up-to-date in the WWW CVS area (the FAQ aside).
This semi-automatic method could handle also publishing in the FTP archive, as
bug #64278 suggests.
That way, instead of having
doc-debian maintainer updates info, notifies www and publishes in FTP (dpkg-distaddfile?)
www maintainer updates info (mailing lists) and notifies doc-debian
www translators to XXX translate info and notify (or build) doc-debian-XXX
we could have:
www maintainers update info in Debian CVS -
www translator translate info in Debian CVS |---> doc-debian packages generated, publish FTP
doc-debian maintainer updates info in Debian CVS -
-- System Information
Debian Release: 2.2
Kernel Version: Linux avalon 2.2.19 #3 Wed Mar 28 14:14:21 CEST 2001 i686 unknown
--- End Message ---
--- Begin Message ---
-----BEGIN PGP SIGNED MESSAGE-----
Le 24/07/2001 20:46, Javier Fernandez-Sanguino Pena a écrit :
> We currently have the same info in the www archive as in the FTP archive
> and some packages (doc-debian for example). We should find a way to provide
> information common to some packages (doc-debian and doc-debian-es, for example
> I just submitted a bug to the latest one) in a semi-automatic way.
It seems like doc-debian(-NN) packages have not been updated in years,
and may contain outdated documentation. It also seems like most
documents that used to be part of doc-debian(-NN)? are now shipped as
their own package, e.g. debian-faq(-NN). Furthermore, most online
documentations on www.d.o are either shipped directly from their
associated package, or built from the DDP Subversion repository (so they
are kept up to date the other way around).
> Common information includes:
> - bug refcards
> - information on bug access and reporting
> - mailing list information
> - social contract
> - constitution
If doc-debian(-NN) packages are still worthy for these documentations, I
do believe that this “semi-automated way to provide info” bug report
should be reassign to the doc-debian(-NN), as it just sounds like some
sort of missing watch file feature (no objection a priori to host a
trigger, or an extra info file online that could feel the blank in order
to ease this bugs handling, but it definitely is not a www.master.org
issue per se).
Another idea would be to host those documents in the DDP or inside their
own packages, and published them on the website as it's done for the
Debian Policy (or the Developer's Reference to give an example of
translated documentation also shipped from its package).
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.12 (GNU/Linux)
-----END PGP SIGNATURE-----
--- End Message ---