Re: Fwd: "A Brief History of Debian: Chapter 2 - Leadership" online page needs some update

classic Classic list List threaded Threaded
5 messages Options
Reply | Threaded
Open this post in threaded view
|

Re: Fwd: "A Brief History of Debian: Chapter 2 - Leadership" online page needs some update

Andrei POPESCU-2
On Sb, 28 mar 20, 21:24:36, [hidden email] wrote:

> Andrei,
>
> 28 mars 2020 à 17:02 de [hidden email]:
>
> > Might I suggest you provide a patch? The sources appear to be on Salsa.
> > https://salsa.debian.org/ddp-team/project-history
> >
> I'm not used to Salsa but are you sure your link is correct?
> Indeed, no merge request about this is in process and everything seems
> to be already OK
> at https://salsa.debian.org/ddp-team/project-history/-/blob/master/project-history.en.dbk:
> "Sam Hartman was elected in April 2019 and is our current leader."
Dear Debian Web Team,

It seams the project history on www is not up to date, Sam Hartman is
missing from the list of Project Leaders.

https://www.debian.org/doc/manuals/project-history/ch-leaders.en.html

Kind regards,
Andrei
--
http://wiki.debian.org/FAQsFromDebianUser

signature.asc (849 bytes) Download Attachment
Reply | Threaded
Open this post in threaded view
|

Re: Fwd: "A Brief History of Debian: Chapter 2 - Leadership" online page needs some update

Laura Arjona Reina-4
Hi all

El 28/3/20 a las 22:11, Andrei POPESCU escribió:

> On Sb, 28 mar 20, 21:24:36, [hidden email] wrote:
>> Andrei,
>>
>> 28 mars 2020 à 17:02 de [hidden email]:
>>
>>> Might I suggest you provide a patch? The sources appear to be on Salsa.
>>> https://salsa.debian.org/ddp-team/project-history
>>>
>> I'm not used to Salsa but are you sure your link is correct?
>> Indeed, no merge request about this is in process and everything seems
>> to be already OK
>> at https://salsa.debian.org/ddp-team/project-history/-/blob/master/project-history.en.dbk:
>> "Sam Hartman was elected in April 2019 and is our current leader."
>
> Dear Debian Web Team,
>
> It seams the project history on www is not up to date, Sam Hartman is
> missing from the list of Project Leaders.

Yes, unfortunately this is one of the consequences of the bug #922222:
we need to adapt the cron script that generate the manuals, so they work
with the repos in salsa (they are failing since the migration alioth ->
salsa).

https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=922222

I guess that until now, nobody could find the time/energy to fix this,
so any help is welcome.

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

Reply | Threaded
Open this post in threaded view
|

Re: Fwd: "A Brief History of Debian: Chapter 2 - Leadership" online page needs some update

Holger Wansing-4
Hi,

Laura Arjona Reina <[hidden email]> wrote:
> Yes, unfortunately this is one of the consequences of the bug #922222:
> we need to adapt the cron script that generate the manuals, so they work
> with the repos in salsa (they are failing since the migration alioth ->
> salsa).
>
> https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=922222
>
> I guess that until now, nobody could find the time/energy to fix this,
> so any help is welcome.

Laura:
I read your proposal in #922222 to deal with this situation.
However, I wonder if we shouldn't switch to the solution, that's used for
other documentation in cron/parts/7doc (means: grap the documentation files
from the latest uploaded package version from the archive, instead of from
VCS repo).

I realize there might be a reason for using a different system here, but as
manpower is an issue everytime here, my argument would be: make the system
easier (use the same system everywhere) instead of maintaining different
solutions.

Of course, this would lead to more packaging work for the relevant doc packages
(for debian-history: we would need to do at least one upload per year, to get
the new leader documented on the website).
But looking at Laura's proposal, we are talking only about a very little number
of packages (if we leave out the /attic ones), so I think that could work.
I would volunteer for that upload work, if per-package upload rights were given
to me.

I have a tested patch for debian-history (against webmaster cron) ready and
attached.
(Once this is up and running on www-master, there are also some changings
needed in webwml though, but they are IMO uncritical.)

Any comments?


Holger


--
Holger Wansing <[hidden email]>
PGP-Fingerprint: 496A C6E8 1442 4B34 8508  3529 59F1 87CA 156E B076

cron-for-debian-history.diff (1K) Download Attachment
Reply | Threaded
Open this post in threaded view
|

Re: Bug#922222: adapt 7doc_manuals cron script to use the multiple git repos in Salsa

Holger Wansing-4
Hi,

Holger Wansing <[hidden email]> wrote:
> Hi,
>
> Holger Wansing <[hidden email]> 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 <[hidden email]>
PGP-Fingerprint: 496A C6E8 1442 4B34 8508  3529 59F1 87CA 156E B076

Reply | Threaded
Open this post in threaded view
|

Bug#922222: marked as done (adapt 7doc_manuals cron script to use the multiple git repos in Salsa)

Debian Bug Tracking System
Your message dated Thu, 16 Apr 2020 22:22:20 +0200
with message-id <[hidden email]>
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 [hidden email]
immediately.)


--
922222: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=922222
Debian Bug Tracking System
Contact [hidden email] with problems

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: [hidden email]
Fecha: Wed, 21 Nov 2018 15:51:35 +0100
De: Laura Arjona Reina <[hidden email]>
Para: [hidden email]
CC: debian-www <[hidden email]>

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

Hi,

Holger Wansing <[hidden email]> wrote:
> Hi,
>
> Holger Wansing <[hidden email]> 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 <[hidden email]>
PGP-Fingerprint: 496A C6E8 1442 4B34 8508  3529 59F1 87CA 156E B076