[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Updating Debian Perl group team page

Hi Cyrille,

> Now that I know a little bit more about Debian packaging and
> the Debian Perl group's policies and habits, I think I might be
> able to help future newcomers, or existing members looking back
> for some reference informations, by improving Debian Perl
> group's documentation.

Improving documentation is always a good thing, so you're very
welcome to contribute :)

> I would like your opinion on the idea of updating
> https://wiki.debian.org/Teams/DebianPerlGroup
> to remove much of the rendundancies and rather refer to
> https://perl-team.pages.debian.net/
> as much as possible.
> Also, adding some explanation or background information and
> context might sometimes be useful.


FWIW, I've been working for a while to build a Debian Perl Group
handbook from the POD files with Sphinx, but the proof of concept
is missing after migrating to salsa (will need to build it with
gitlab-ci eventually). Take a look at the Makefile in the repo
for the details.

While building the handbook I found out that a large source of
redundacy in the documentation comes from the fact that we have
POD docs in our tooling (e.g. pkg-perl-tools) that is also
on the website docs (and sometimes are not in sync or information
is split). Therefore, in some cases we may need to link to
manpages.debian.org instead, e.g.



  ⣾⠁⢠⠒⠀⣿⡁  Alex Muntada <alexm@debian.org>
  ⢿⡄⠘⠷⠚⠋   Debian Developer - log.alexm.org

Attachment: signature.asc
Description: PGP signature

Reply to: