str, list and friends are both functions and classes, if you want to go that way :)  Let’s keep purism out of this and discuss the result: we agree that missing links are a problem, so let’s fix it.

> How could it possibly work
What’s missing is class and method directives.  If you’re interested in submitting a patch, guidelines are found at http://docs.python.org/dev/documenting/markup#information-units and http://docs.python.org/devguide

> without decent documentation about the list data type?
I can understand your feelings, but such a comment is a bit harsh for all the volunteer time that’s been put into documenting Python.  http://docs.python.org/dev/library/functions#list and http://docs.python.org/dev/library/stdtypes#typesseq seem quite “decent” to me.