1653049 - Support tables in Markdown

Status: RESOLVED FIXED

(Developer Infrastructure :: Source Documentation, enhancement)

Description

[Mitchell Hentges [:mhentges] 🦀]

We're collecting build telemetry with Glean, and Glean generates markdown documentation describing the telemetry and visualizes it with a table (here's an example from a different project).

The in-tree docs system already supports markdown, but it doesn't render markdown tables.
It looks like there's an solution: an (immature?) extension for sphinx

Comment 1

[Mitchell Hentges [:mhentges] 🦀]

CC-ing chutten on the Glean team because future project in-tree using Glean will want to be able to use the generated documentation

Comment 2

[Mitchell Hentges [:mhentges] 🦀]

Attachment: Bug 1653049: Docs support markdown tables

Glean generates telemetry documentation in markdown and uses tables.

This revision adds support for rendering markdown tables using an extension.

Depends on D83012

Comment 3

[Shivam Singhal [ :championshuttler ]]

Awesome Idea Mitchell, lets add this thanks!

Comment 4

[Pulsebot]

Pushed by [e-mail]:
https://hg.mozilla.org/integration/autoland/rev/80475e27b91b
Docs support markdown tables r=championshuttler

Comment 5

[Bogdan Tara[:bogdan_tara | bogdant]]

https://hg.mozilla.org/mozilla-central/rev/80475e27b91b