Use tables in developer docs

[brainwane]

Our https://zulip.readthedocs.io/ developer documentation is in Markdown files in docs/, rendered into HTML using Sphinx. Per readthedocs/recommonmark#3 (comment) , we can now use tables in our docs by using the sphinx-markdown-tables Sphinx extension (source: https://github.com/ryanfox/sphinx-markdown-tables ).

Maybe we should use this. Some of our bullet lists would perhaps be easier to read as tables. Examples:

• https://zulip.readthedocs.io/en/latest/tutorials/new-feature-tutorial.html#update-the-front-end
• https://zulip.readthedocs.io/en/latest/contributing/code-style.html#naive-datetime-objects
• https://zulip.readthedocs.io/en/latest/subsystems/dependencies.html#system-packages
• https://zulip.readthedocs.io/en/latest/subsystems/dependencies.html#modifying-provisioning
• https://zulip.readthedocs.io/en/latest/tutorials/life-of-a-request.html#api-endpoints-use-rest
• https://zulip.readthedocs.io/en/latest/production/authentication-methods.html#plug-and-play-sso-google-github-ldap

[zulipbot]

Hello @zulip/server-development members, this issue was labeled with the "area: documentation (developer)" label, so you may want to check it out!

[jdimaria3]

@zulipbot claim

[zulipbot]

Hello @jdimaria3!

Thanks for your interest in Zulip! You have attempted to claim an issue without the labels "help wanted", "good first issue". Since you're a new contributor, you can only claim and submit pull requests for issues with the help wanted or good first issue labels.

If this is your first time here, we recommend reading our guide for new contributors before getting started.

[brainwane]

We could also check out MyST which is new https://myst-parser.readthedocs.io/en/latest/index.html :

"We've been working on a Sphinx extension that lets you write Sphinx docs in 💯 markdown (incl. roles and directives). We call it "MyST Markdown" (for "Markedly Structured Text").

[andersk]

I opened #19548 migrating to MyST-Parser. This allows us to use GFM-style tables (and I converted the one reST table we have).