Il 05/08/2024 10:40, Simon Richter ha scritto:
debian/README.source can be used for that, this according to the current documentation does partially that, make it standard also for other parts mentioned, more known thing and change/improve the documentation, for example in https://www.debian.org/doc/debian-policy/ch-source.html#source-package-handling-debian-readme-source as at the moment reading at the beginning it leaves to understand to a restricted use of it, can be an improvement with minimal effort.Hi,On 8/5/24 17:10, Fabio Fantoni wrote:currently you find such information from a simple search and/or looking a bit in the source, in the possible git in a few minutes only in part of cases, in many other cases instead it requires more time, the possible contact of the maintainer, attempts (and then eventually feel that it would be better to "improve" your contributions using other methods).This information should be in debian/README.source. Simon
for example also in the end of it description have:
|debian/README.source| may also include any other information that would be helpful to someone modifying the source package. Even if the package doesn’t fit the above description, maintainers are encouraged to document in a |debian/README.source| file any source package with a particularly complex or unintuitive source layout or build system (for example, a package that builds the same source multiple times to generate different binary packages).that it may suggest a greater use than what I saw and remembered but at least something like this should be put at the beginning of the description: "debian/README.source may include any information that would be helpful to someone modifying the source package and how to contribute to it"
could suggest to optionally add other parts on how to contribute that have been discussed, to insert any external links where to find the information (in order to update a single page/file even for a big amount of packages, but leaving README.source unchanged, so I guess it would be much more used thanks to less effort from the maintainers)
OpenPGP_signature.asc
Description: OpenPGP digital signature
