Bug#612993: Info received (BYHAND rules for debian-faq / Re: Bug#612993: Converted debian-faq to DocBook)

[Debian Bug Tracking System]

Thank you for the additional information you have supplied regarding
this Bug report.

This is an automatically generated reply to let you know your message
has been received.

Your message is being forwarded to the package maintainers and other
interested parties for their attention; they will reply in due course.

Your message has been sent to the package maintainer(s):
Javier Fernandez-Sanguino Peña <***@debian.org>

If you wish to submit further information on this problem, please
send it to ***@bugs.debian.org.

Please do not send mail to ***@bugs.debian.org unless you wish
to report a problem with the Bug-tracking system.

[Javier Fernandez-Sanguino]

On Mon, 8 Jul 2019 at 06:55, Joost van Baal-Ilić <

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.

Correct, this is where they are used.

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.

Also relevant is that the documents from the mirror are used in the
DVD/CD/Blu-ray images. I would rather continue shiping the FAQ via the
mirrors.

This currently means using BYHAND rules, but maybe ftp-master can propose
an alternative mechanism to sync the contents to that directory? (there
could be a regular task to pull the information from the package or to pull
from the web).

I personally like our mirrors to be somewhat self-contained by shipping

not just software but also some instructions.

I agreed with the above. Specially considering that some may receive this
content not via the mirrors network but via the media we prepare/distribute
with each release.

Best regards

Javier

[Dr. Tobias Quathamer]

Post by Javier Fernandez-Sanguino
Also relevant is that the documents from the mirror are used in the
DVD/CD/Blu-ray images. I would rather continue shiping the FAQ via the
mirrors.
This currently means using BYHAND rules, but maybe ftp-master can
propose an alternative mechanism to sync the contents to that directory?
(there could be a regular task to pull the information from the package
or to pull from the web). 
I personally like our mirrors to be somewhat self-contained by shipping
not just software but also some instructions.
I agreed with the above. Specially considering that some may receive
this content not via the mirrors network but via the media we
prepare/distribute with each release.

Hi,

you're right, I've re-added those BYHAND rules and the converted package
builds fine for me. I think we should create a release soon, so that we
can see if everything still works as expected. More testers are welcome!

Your suggestion with an alternative mechanism for ftp-master to update
those files on the archive mirrors (instead of BYHAND) is great. We
should ask them about ideas how this could work. However, I think they
may need some time off so shortly after the release ... :-)

Regards,
Tobias

[Joost van Baal-Ilić]

Hi again,

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.
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 just managed to build the package, and had a very quick look at the
result. It looks good to me, at first sight. I don't see any problem which
would prevent us from uploading.

Thanks again for your work!

Bye,

Joost