On Sun, Jul 07, 2019 at 10:39:17PM +0200, Dr. Tobias Quathamer wrote: > Am 07.07.19 um 14:56 schrieb Javier Fernandez-Sanguino: > > Thank you very much for your work on this Tobias. With the new buster > > release we have to upload some content changes (and bump the version to > > '10'). > > > > I can review the debian/rules in the coming days and modify it to work > > for docbook. > > Hi Javier, > > I did some more work on the Makefile and d/rules, now the package builds > fine for me.
Awesome! > I'd like to upload in the next days, so we have plenty of time during > this release cycle to identify and fix problems with the new infrastructure. > I've removed the BYHAND rules, because those rules are a burden for > FTPMasters and I think that the website > (https://www.debian.org/doc/manuals/debian-faq/) does no longer need > them. I've found a commit from eight years ago which suggests this: > https://salsa.debian.org/webmaster-team/cron/commit/6f39ebcbeadac23d1c1e0d70af8faeecfd6f6d25 > The only place where the BYHAND rules might still be needed is from the > fileservers (https://deb.debian.org/debian/doc/FAQ), Yes, afaik that's indeed what they're used for. > and I think that > nowadays the availability on the main website should suffice. > > What do you think? https://deb.debian.org/debian/doc/ also has documents we ship with the doc-debian package (social-contract, constitution, bug-reporting etc.) _If_ we choose to no longer ship the FAQ via the mirrors, we might also want to discuss what to do with these other documents. Some distros (e.g. FreeBSD, Slackware) still ship a FAQ via their mirror network: http://ftp.nluug.nl/FreeBSD/doc/faq/ http://ftp.nluug.nl/os/Linux/distr/slackware/slackware/FAQ.TXT Red Hat ships some info, but not really a FAQ: http://ftp.nluug.nl/os/Linux/distr/RedHat/ftp/redhat/rhel/rhel-8-beta/README GNU did what we're discussing here: removing their FAQ from their mirrors: http://ftp.nluug.nl/gnu/GNUinfo/README "Information about the GNU project and instructions for maintainers used to be available here. This information may now be found at http://www.gnu.org/prep and in the Emacs CVS repository." I couldn't find any faq-like document for fedora or SUSE on the mirrors: http://ftp.nluug.nl/os/Linux/distr/fedora/ http://ftp.nluug.nl/os/Linux/distr/suse/ I personally like our mirrors to be somewhat self-contained by shipping not just software but also some instructions. I feel this should be discussed on debian-doc@l.d.o, reply-to set. Bye, Joost
