Re: Complete and unified documentation for new maintainers
Le 2025-01-11 13:49, Fabio Fantoni a écrit :
What would be the best, easiest and fastest procedure (especially for
newcomers) to create a new package from scratch, aiming to use git,
salsa, salsa-ci, gbp and DEP14 from the beginning?
It Depends™. As in, it really depends on what you are packaging.
Different technologies have different Debian-specific tools, different
teams have different workflows, there are exceptions, and there are
exceptions to the exceptions.
There are indeed things that are common to all packaging, but IMO as
well as IME trying to document a generic, theoretical trunk that is
rarely used as-is is confusing, overwhelming and not really helpful to
newcomers. That's material for reference manuals, but newcomers should
probably first be guided through a reasonably simple step-by-step
tutorial and then practical cases and examples covering the nominal
packaging practices as adopted by the different clans.
The tutorial could for example show how to properly package a Gnome
game. I randomly picked [1] which already looks like a reasonable pick
for that purpose, but there might be better ones. It might help to craft
a packaging "reference implementation" out of a carefully chosen
project, and publish a frozen demo git repository that could be cloned
and used along the tutorial.
Practices that are specific to teams or maintainers should be documented
by them, as they are in the best place to know what is current and what
is not, and this is not always trivial from an outsider's point of view
(or there might be lingering disagreements over what should be
considered "best" practices). For example I know that the Java packaging
documentation needs to be improved (and the tooling as well) and I'm
planning to work on that later this year.
Cheers,
[1]: https://salsa.debian.org/gnome-team/gnome-2048
--
Julien Plissonneau Duquène
Reply to: