How much should we port from sphinx and sphinx design?

[Mpdreamz]

Our markitpy-samples includes several extensions over myst itself

• sphinx includes additional directives (see also) [meta] Supported Directives #2
  Which ones do we port over that are not listed on the meta issue?

• sphinx-design includes its own directives for grids e.g compare:

  • https://sphinx-design.readthedocs.io/en/latest/grids.html
  • https://mystmd.org/guide/dropdowns-cards-and-tabs
    For reference this POC implements the sphinx-design way of doing grids.

• This POC currently supports attr-inline however I fear this gives to much power to the end user. We want to be restrictive and ensure the resulting HTML is always uniform. How much should we support?

How do we want to position our docs-builder ?

• A pure Myst compatible documentation tool
• Myst as baseline with a few directives from sphinx
• Myst and subset of Sphinx as baseline with grids from Sphinx-Design ?

I am personally leaning to the latter.