Currently the man pages are formatted using the roff format. While man requires the format, it is also very hard to read and can easily lead to formatting issues, e.g. by forgetting to end a block. It would be better to use a format that is better for humans to read, e.g. ReStructuredText (rst) or Markdown (md), and then convert it to roff using tools like docutils or pandoc.
Currently the man pages are formatted using the roff format. While
manrequires the format, it is also very hard to read and can easily lead to formatting issues, e.g. by forgetting to end a block. It would be better to use a format that is better for humans to read, e.g. ReStructuredText (rst) or Markdown (md), and then convert it to roff using tools like docutils or pandoc.