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. Cool! 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 <https://salsa.debian.org/perl-team/perl-team.pages.debian.net> 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. https://perl-team.pages.debian.net/forward.html https://manpages.debian.org/unstable/pkg-perl-tools/dpt-forward.1.en.html Cheers! Alex -- ⢀⣴⠾⠻⢶⣦⠀ ⣾⠁⢠⠒⠀⣿⡁ Alex Muntada <alexm@debian.org> ⢿⡄⠘⠷⠚⠋ Debian Developer - log.alexm.org ⠈⠳⣄⠀⠀⠀⠀
Attachment:
signature.asc
Description: PGP signature