When DDP was started, those people had big plan.  But in reality, scope
has been scaled back.

Since there is no big pile of Debian document and most (Policy,
DevRef,...) now uses their own doc directory, I think it's about time
for FAQ to be in line with others.

This should help people to find this document easily since doc-base
support is scant and rarely used by newbies.

I agree.

But how about the doc-debian package? That one now installs :

/usr/share/doc/debian/bug-log-access.txt
/usr/share/doc/debian/bug-*.txt.gz
/usr/share/doc/debian/bug-reporting.txt.gz
/usr/share/doc/debian/constitution.*txt.gz
/usr/share/doc/debian/debian-manifesto.gz
/usr/share/doc/debian/mailing-lists.txt.gz
/usr/share/doc/debian/social-contract.*txt.gz
/usr/share/doc/debian/source-unpack.txt

If those documents get moved, we can get rid of /usr/share/doc/debian/ .

However, I myself am not quite sure if moving these documents is the right
thing to do.  Opinions?

Bye,

Joost

Hi,

Good catch.  True.

I think it is good idea but its worth thinking.

If we do this, we need to update debwww cron script.

Before then, we should stop using FTP servive in cron script.

Osamu

Hi again,

[Dropping debian-doc; I believe the list gets a copy via 998160@bugs.d.o
anyway.]

I was brave enough to again have a look at cron/parts/7doc ...  :-/

Note to self: once debian-faq ships new translations (pt and ko) we
might have to adjust 7doc again.

Osamu: or is there another script in webmaster-team/cron I should
have a look at?

Osamu: stop using FTP service: you mean the script parts/1ftpfiles which seems
to try to access ftp://ftp.de.debian.org/debian/pool/main ?  (I just found out
we still offer ftp access... Wow...) But uhm, is that script still being run
from cron?  If so I might be able to fix that, one of these days.

Thanks, Bye,

Joost

Hi,


I have written code to use http instead of ftp locally.  It needs to be tested.

Give me some time to test to avoid regressions.

Osamu

Hi Osamu e.a.,

Excellent, thanks!

I found around line 475 of cron/parts/7doc, there is

 ln -sf debian-faq.zh-cn.pdf $webdocdir/manuals/debian-faq/debian-faq.zh_CN.pdf
 ln -sf debian-faq.zh-cn.txt $webdocdir/manuals/debian-faq/debian-faq.zh_CN.txt

.  I didn't see any other special casing of specific languages in debian-faq,
so I think we don't need to do any adjustments for new translations (pt and
ko).

I'll try to set up a test-instance myself here.  (I have only 19 GB free disk
space available here now; hope that'll be enough...)

Bye,

Joost

PS/note to self: https://www.debian.org/doc/manuals/debian-faq/ honors browser
language settings.  Page https://www.debian.org/doc/user-manuals#faq has an
explicit listing of available languages, might need adjustment.  Translated
content available directly via e.g.
https://www.debian.org/doc/manuals/debian-faq/index.de.html and
https://www.debian.org/doc/manuals/debian-faq/debian-faq.fr.pdf .

Hi,

If I remember correctly, I needed to change some file extension to match the HTML web
page generated by webwml with minimal efforts.  pt_BR and zh_** always make things
more complicated.

With new code, useless downloads of old packages are avoided.  So things should be
better.

Osamu

The language additions usually need updating manuals.defs in webwml/english/doc