Pradyun Gedam

Not a maintainer and... my thoughts on the two easy questions: > How are nested directives handled? Should they be in the toc or not? E.g., > ``` > .....

> If that's the design, how to express the other 2 cases: Why do you want to? I don't think there's much value in trying to design to accommodate for...

FWIW, you can see the API usage in https://github.com/bloomberg/memray/blob/main/tests/integration/test_api.py#L12 and do things using that, if you want to get to that before we get the docs written down and published!...

@knaitas Could you clarify what you mean by "poetry CLI command"? Are you referring to https://python-poetry.org/docs/pyproject/#scripts?

I'd be more than happy to help out with this -- see also https://github.com/sphinx-doc/sphinx/issues/10419#issuecomment-1181695008 where I responded to the suggestion of borrowing the new things from basic-ng!

Honestly, I’d even be fine if this wasn’t exposed in toctree, and just exposed in the underlying implementation.

Ah, I thought I'd responded here already! The motivation for basic-ng being developed outside of Sphinx is that it's currently moving at a much faster development cadence that Sphinx itself....

I'm totally on board for improving Sphinx's basic theme, as much as we can, and if we'd pull in any bits and pieces from basic-ng, that'd be great as well....

I think it's a healthy thing to do. In the curve of popular vs nimble, Sphinx is firmly on the popular end of the spectrum and can't be very nimble....

This information is not stored in the metadata by pip. The only way to get this is going to be possible is by controlling the pip install call, and checking...