René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"API Reference not populated in online docs","articleBody":"In the [Read the Docs](http://gitpython.readthedocs.org/) deployment, [**the API Reference page**](https://gitpython.readthedocs.io/en/stable/reference.html#api-reference-toplevel) is unpopulated: the sections exist, but they do not contain any entries from the classes, functions, etc., that are supposed to go there.\r\n\r\nThis only affects the online documentation. Building the documentation locally still works with `make -C doc html`, provided the necessary dependencies are installed, and the API Reference page is fully populated. (This is how I have usually verified tricky or substantial changes to the documentation, and I was able to do it with no problems to check #1839.)\r\n\r\nFurthermore, it only affects documentation from after #1794 was fixed. For a while before it was fixed, no new documentation was deployed online. But the API Reference page worked before that, and still works when accessed on readthedocs.org for those old versions.\r\n\r\nIt seems the changes made in 634151a to fix #1794 were sufficient to get documentation to build again, but not sufficient to set up Read the Docs in such a way that it would be able to populate members for code like:\r\n\r\nhttps://github.com/gitpython-developers/GitPython/blob/afa575454f85b34800460881cc9c3cd7fe78c8e3/doc/source/reference.rst?plain=1#L128-L131\r\n\r\nI don't know why this is or how best to investigate it, and I am not experienced with Read the Docs. But a couple of possibilities occur to me, both based in part on my observation that, when I build the documentation locally, the generated documentation shows values for attributes that are populated from environment variables, where the value I set for the environment variable is the value shown in the documentation. In other words, building the documentation relies on being able to import the modules and makes use of state set from running their top-level code.\r\n\r\nIf Read the Docs is itself (re)building the documentation--which if I understand correctly is what the new `.readthedocs.yaml` configures--then perhaps it is unable to successfully import those modules:\r\n\r\n1. Does it have the necessary Python dependencies?\r\n2. Does the container that builds the documentation have a `git` command?\r\n\r\nI reiterate that Read the Docs deployment is not an area where I am currently knowledgeable.","author":{"url":"https://github.com/EliahKagan","@type":"Person","name":"EliahKagan"},"datePublished":"2024-02-23T07:18:48.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":1},"url":"https://github.com/1840/GitPython/issues/1840"}