Your message dated Thu, 16 Apr 2020 22:22:20 +0200
with message-id <20200416222220.611d23088e279469f1c04...@mailbox.org>
and subject line Re: Bug#922222: adapt 7doc_manuals cron script to use the 
multiple git repos in Salsa
has caused the Debian Bug report #922222,
regarding adapt 7doc_manuals cron script to use the multiple git repos in Salsa
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 ow...@bugs.debian.org
immediately.)


-- 
922222: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=922222
Debian Bug Tracking System
Contact ow...@bugs.debian.org with problems
--- Begin Message ---
Package: www.debian.org
Severity: normal

Hello
I am opening a bug so this is not forgotten.
Kind regards

--
Laura Arjona Reina
https://wiki.debian.org/LauraArjona


-------- Mensaje reenviado --------
Asunto: Re: 7doc_manuals cron script fails (trying to access svn repo in Alioth)
Resent-Date: Wed, 21 Nov 2018 15:20:02 +0000 (UTC)
Resent-From: debian-...@lists.debian.org
Fecha: Wed, 21 Nov 2018 15:51:35 +0100
De: Laura Arjona Reina <larj...@debian.org>
Para: debian-...@lists.debian.org
CC: debian-www <debian-www@lists.debian.org>

Hello web and documentation teams,

El 31/5/18 a las 23:57, Laura Arjona Reina escribió:
Hello Debian Documentation team:

One of the scripts that we use to build the Debian website
(www.debian.org), 7doc_manuals, does not work anymore.

Source code:

https://salsa.debian.org/webmaster-team/cron/blob/master/parts/7doc_manuals

It tries to access svn repo(s) in alioth:

svn export --force svn://svn.debian.org/svn/ddp/manuals . > svn.log 2>&1

and they are not available anymore.

Can you update it to access the corresponding repo in salsa? (or give us
a hint about what to do).


I've been looking at the code of the 7doc_manuals script:

https://salsa.debian.org/webmaster-team/cron/blob/master/parts/7doc_manuals

and the current organisation of the ddp repos in Salsa.

I've listed all the manuals that were built from the original SVN "manuals" repo, reviewed case by case, and this is my proposal:

1.- The following manuals show "Obsolete documentation" in their first page of the content, and also are hosted now under https://salsa.debian.org/ddp-team/attic:

apt-howto
book-suggestions
ddp-policy -> would close #147164 www.debian.org: DDP: DDP policy is too out of date
dictionary
debian-euro-support
meta
network-administrator
programmer
repository-howto
system-administrator
tutorial
user
users-guide

so I propose remove them from the "7doc_manuals" build script and remove the manuals from the Debian website. Then, in the pages where we link to them, change the link to point to the corresponding attic repo and add a note about "obsolete documentation" (if it's not there yet). The person wanting to get the obsolete manuals, can download the repo and build themselves.

2.- The following manuals don't include the text "Obsolete documentation", but they are hosted in https://salsa.debian.org/ddp-team/attic, so I'm not sure what to do:

debian-bugs (in attic)
distribute-deb (in attic)
dselect-beginner (in attic)
fr/debian-fr-howto
intro-i18n

For now, I propose to remove them from the build script and keep the copy built in May 2018 in the Debian website. Maybe add a README file in the webwml repo in english/doc explaining where are the repos for the case it's needed to build them again.

3.- The following manuals are current, so I (if nobody beats me to it) will adapt the script to get the last changes from the current git repo, and build:

https://salsa.debian.org/ddp-team/hamradio-handbook.git

https://salsa.debian.org/ddp-team/java-faq.git

4.- The following manuals are current, but the current "make" command in the 7doc_manuals script would not work even if we get the git repos. I appreciate help to adapt the 7doc_manuals script for these:

https://salsa.debian.org/ddp-team/project-history.git
make -C project-history publish PUBLISHDIR=/srv/www.debian.org/www/doc/manuals install_file="install -p -m 664" install_dir="install -d -m 2775"
make: *** No rule to make target 'publish'.  Stop.

https://salsa.debian.org/ddp-team/securing-debian-manual.git
make -C securing-howto publish PUBLISHDIR=/srv/www.debian.org/www/doc/manuals install_file="install -p -m 664" install_dir="install -d -m 2775"
make: *** No rule to make target 'publish'.  Stop.

Comments welcome.
Kind regards

--
Laura Arjona Reina
https://wiki.debian.org/LauraArjona

--- End Message ---
--- Begin Message ---
Hi,

Holger Wansing <hwans...@mailbox.org> wrote:
> Hi,
> 
> Holger Wansing <hwans...@mailbox.org> wrote:
> > > If noone objects, I will implement this solution then.
> > 
> > In a first step, I have now added debian-history to 7doc as well.
> > Will see how it goes - fingers crossed...
> 
> And now hamradio-maintguide and harden-doc added to 7doc.

This three manuals are now integrated in 7doc cron script and also in
webwml.
Additionally, I have moved some more outdated manuals to the obsolete page
(intro-i18n, Debiandoc-SGML-Markup manual, Debian SGML/XML Howto).
So, all manuals that were identified as outdated/obsolete in this bug, are now
on the obsolete page.

Thus, the issue of this bugreport is solved and I'm closing it.


Holger


-- 
Holger Wansing <hwans...@mailbox.org>
PGP-Fingerprint: 496A C6E8 1442 4B34 8508  3529 59F1 87CA 156E B076

--- End Message ---

Reply via email to