Bug#1087820: debian-policy: allows README.source.md alternatively
On Mon, Nov 18, 2024 at 11:01:56PM -0800, Otto Kekäläinen wrote:
> Package: debian-policy
> Found: 4.7.0.1
>
> Currently https://www.debian.org/doc/debian-policy/ch-source.html#source-package-handling-debian-readme-source
> talks about `README.source`.
>
> I suggest we would allow this file to alternatively be in Markdown
> format, and spell the filename as `README.source(.md)`.
>
> The suffix is relevant as many tools recognize the file as Markdown
> based on the suffix and will only render it correctly with the suffix.
> I am proposing Markdown specifically as it has become an industry
> standard for ASCII markup and use on README.md files is very common.
Are there tools that automatically locate README.source and would need to be adapted to
find README.source.md instead ?
Cheers,
--
Bill. <ballombe@debian.org>
Imagine a large red swirl here.
Reply to: