Possible reference link: "A guided tour from the Python REPL to PyPI & beyond"

https://veekaybee.github.io/2017/09/26/python-packaging/ is an interesting article from @veekaybee that starts from the simplest possible Python component (a single statement at the REPL), and works its way all the way through to publication of a package with multiple submodules.

(Note: the article's actual title is "Alice in Python projectland", so the quoted bit in the issue title is just how I'd summarise what it's about)

https://packaging.python.org/tutorials/distributing-packages/#configuring-your-project is deliberately very prescriptive without really answering many "Why is it so?" questions, so this could be a good "See Also:" link at the start of that section for folks that want a better understanding of the bigger picture, rather than just following a prescriptive recipe.

Read the packaging.python.org “Configuring your project” section and the linked “Alice in Python projectland” article. Add the article as a See Also link at the start of that section, then verify that the rendered documentation link works and provides the intended broader explanation.