>>>>> "Jeremy" == Jeremy Bícha <jeremy.bi...@canonical.com> writes:

FWIW, I think it is desirable to get as many man pages as we can.
To that end, I hope policy continues to:

*encourage writing man pages

* Encourage maintainers to take well written man pages as patches.

At the time that section of policy was last written, allowing people to
open bugs on missing man pages of non-RC severity (that's what should
means in policy language) was the way to do that.

I'm happy to  support text that reduces the bookkeeping requirements of
accomplishing those goals.
I do think it is reasonable to encourage maintainers to write man pages;
I do think well written man pages improve packages.
I understand maintainers have a lot on their plates, and I think it is
fine if  they don't spend the time improving packages in that way.

I do think a missing man page lintia tag is valuable, even at error
severity, although I would not stand in the way of consensus if others
disagree with me on this point.
I think overriding that tag is a fine way to mark that you are aware of
the missing man page and choose not to work on it now.


I cannot be part of a consensus that goes against the bulleted points I
have listed above.

Reply via email to