>>>>> "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.