Skip to content

Conversation

@feanil
Copy link
Contributor

@feanil feanil commented Jan 20, 2026

Sphinx tries to explore all the defined objects when trying to generate
docs from the code. When it tries to introspect the QuerySet object, it
results in that object trying to query the database which we don't
really want to setup for a docs build as it's not relevant and fairly
expensive to do. To circumvent this issue, we add a new filter to the
docs build that essentially skips further introspection of QuerySet
objects.

@feanil feanil requested a review from sarina January 20, 2026 21:54
@feanil feanil marked this pull request as ready for review January 20, 2026 21:54
Sphinx tries to explore all the defined objects when trying to generate
docs from the code.  When it tries to introspect the QuerySet object, it
results in that object trying to query the database which we don't
really want to setup for a docs build as it's not relevant and fairly
expensive to do.  To circumvent this issue, we add a new filter to the
docs build that essentially skips further introspection of QuerySet
objects.
@feanil feanil force-pushed the feanil/fix_docs_build branch from ab9009e to 53d5e7b Compare January 20, 2026 22:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants