<div dir="ltr">We just merged a large change to the documentation into the main branch. This integrates the manual pages into the documentation build with Sphinx, so you can do things like<div><br></div><div>- Find manual page content with the website search box<br></div><div>- Add images, inline code, equations, citations, links to the users manual, etc. on the man pages <br></div><div><br></div><div>Check it out at <a href="http://petsc.org/main/docs/manualpages" target="_blank">petsc.org/main/docs/manualpages</a> . For an example of a manual page updated to take advantage of the new features, search for "PCFIELDSPLIT". <br></div><div><br></div><div>This is accomplished by allowing inline MyST (Markdown) syntax [1] in the usual man page blocks in the source code. More details at the MR [2].</div><div><br></div><div>Unlike most previous docs changes, this has only been done on the main branch. So, <b>*until PETSc 3.18 is released, make documentation MRs to main*</b>, unless fixing something particularly critical on the release branch, or making a change which you've tested won't cause (serious) merge conflicts when release is merged into main.<br></div><div><br></div><div>I'm hoping that developers will try using the man pages at <a href="http://petsc.org/main" target="_blank">petsc.org/main</a> and thus be able to give feedback. There are a number of known issues, and hopefully the most egregious of these can be resolved before the release. You can find links to these issues in the MR description [2] or on the list of "docs"-labelled issues on GitLab [3]. If so inclined, <b><br></b></div><div><b><br></b></div><div>- use the thumbs-up and thumbs-down buttons on the issues to help prioritize <br></div><div>- comment about formatting on issue #1156 [4] <br></div><div>- suggest candidates for specific man pages to make prettier at  #1155 [5] <br></div><div>- add comments on other topics to existing issues or open new ones (with the "docs" label)</div><div>- assign yourself to any issues you'd like to be involved in resolving<br></div><div><br></div><div>[1]: <a href="https://myst-parser.readthedocs.io/en/latest/index.html" target="_blank">https://myst-parser.readthedocs.io/en/latest/index.html</a></div><div>[2]: <a href="https://gitlab.com/petsc/petsc/-/merge_requests/4989" target="_blank">https://gitlab.com/petsc/petsc/-/merge_requests/4989</a></div><div>[3]: <a href="https://gitlab.com/petsc/petsc/-/issues/?sort=updated_desc&state=opened&label_name%5B%5D=docs" target="_blank">https://gitlab.com/petsc/petsc/-/issues/?sort=updated_desc&state=opened&label_name%5B%5D=docs</a></div><div>[4]: <a href="https://gitlab.com/petsc/petsc/-/issues/1156" target="_blank">https://gitlab.com/petsc/petsc/-/issues/1156</a></div><div>[5]: <a href="https://gitlab.com/petsc/petsc/-/issues/1155" target="_blank">https://gitlab.com/petsc/petsc/-/issues/1155</a></div><div>[6]: <a href="https://petsc.org/main/docs/manualpages/PC/PCFIELDSPLIT" target="_blank">https://petsc.org/main/docs/manualpages/PC/PCFIELDSPLIT</a></div><div><br></div><div><br></div></div>