I think the docs are often too verbose. Many pages start with a long winded intro that misses the main point. Some pages never get to the point. Docstrings are

I think the docs are often too verbose. Many pages start with a long winded intro that misses the main point. Some pages never get to the point. Docstrings are sometimes several pages long. Example of not getting to the point: Extending/Embedding. There is no fundamental difference. In both cases you're just calling a bunch of functions from libpython.a.