Remove sphinx-needs plugin

[redeboer]

Tasks

Beta Give feedback

1. Remove pr and issue roles (does not work well with jupyterlab-myst)
2. Remove sphinx_issues plugin
3. Replace all need roles with doc links
4. Convert all spec directives to card
5. Add links to related PRs and issues in card footer
6. Convert sphinx-needs tags to cell tags of the card cell. These will be used by the script that create a DataTable of reports.
7. Remove sphinx-needs
8. Convert needtable to data table generated by script. See here for inspiration

Original post

The problem seems to be caused by sphinx-needs, which we use to structure and interlink the technical reports (e.g. the table at compwa-org.rtfd.io/reports.html). Once the sphinx_needs extension has been disabled (564e827), Plotly figures are visible again (removing any need or spec directives from the notebook also does not fix the problem).

An alternative for organizing report notebooks may be sphinx-gallery, but this does not seem to work well with MyST-NB. Ideally, we want to have something like learn.astropy.org, where you can search for notebooks with filters etc.

Some alternatives:

• Write some script that creates a DataTable from the TR notebooks, just like EBP's feature vote.
• ablog.rtfd.io
  No longer actively maintained
• learn.astropy.org
  Looks best, but we would have to Gatsby, a whole different ecosystem than Sphinx
  Originally posted by @redeboer in Plotly plots of Riemann sheets are not showing on ComPWA webpage  #206 (comment)