On Fri, Jan 24, 2025 at 09:04:28PM -0700, Sam Hartman wrote: > >>>>> "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.
I will go as far as saying that of all package documentation we provide, man pages are the most useful, because you can just do 'man somecommand' and get something even if you have no idea what somecommand is supposed to do. On the other hand, we spend lot of time packaging doc in HTML or PDF format that users never use. Instead they do random internet search and then complain that the documentation they found on some website does not match the version of the software in their Debian distribution. This is rather depressing both from the Debian point of view and the upstream point of view. I anticipate the problem is only going to become worse. I do not know what we can do about it. Cheers, -- Bill. <ballo...@debian.org> Imagine a large red swirl here.
