RFR: 8344056: Use markdown format for man pages

[Jonathan Gibbons]

On Wed, 13 Nov 2024 20:17:24 GMT, Kevin Walls <kevinw at openjdk.org> wrote:

> I think this means the one-true-master copy of a man page is now the public .md file. All contributors can now change and improve man pages, and would be expected to make necessary man page updates when making other changes. (Which is great, I just didn't see it being explicitly said.)

Yes, related: 
Non-trivial updates to these pages should be approved in a CSR, maybe along with any code changes that may make such an update necessary.

-------------

PR Comment: https://git.openjdk.org/jdk/pull/22081#issuecomment-2474804913