The Python documentation should borrow the idea from the PHP.net

Perhaps we’re experiencing the cognitive bias known as the Curse of Knowledge, and I genuinely want to identify what’s lacking in the current documentation.

For example, in my opinion, an example isn’t necessary for the function discussed at: The Documentation for PyList_GetSlice could provide example usage