> There is no documentation I've ever seen that's better it clearer.

You should check out Django's documentation: https://docs.djangoproject.com/en/1.11/

In my opinion, it is the gold standard.