chore(dep): add sphinx-needs

[HaoZeke]

Why?

Backlinks.

What?



...

---

📚 Documentation preview 📚: https://metatrain--764.org.readthedocs.build/en/764/

[HaoZeke]

FWIW https://sphinx-needs.readthedocs.io/en/latest/tutorial.html seems to be fairly fancy.

[Luthaf]

If we decide to use this, it will need some CSS tweaks. The big grey boxes are not very nice to look at =)

[Luthaf]

I'm also not sure we really want something like this, I think we should start with the simplest thing, which here would be manual links to prerequisites. Then if we realize we are using manual links a lot and it is getting painful to manage, we can try to introduce a dependency to simplify

[HaoZeke]

I'm also not sure we really want something like this, I think we should start with the simplest thing, which here would be manual links to prerequisites. Then if we realize we are using manual links a lot and it is getting painful to manage, we can try to introduce a dependency to simplify

I kinda disagree, needs basically adds a full SQL style query by tag thing which makes it much easier for people to link stuff.

eg.

and

... to the point where if we do adopt it then users will be able to link everything correct even if they aren't aware of what they're linking to 😄

[Luthaf]

We can discuss it with everyone, but it does fall in the "new feature" category IMO =).