Agreed - documentation lacks in frustrating ways at times. For example the docs [1] for migrating to their new python client are still lacking despite cornering developers into upgrading (don't offer support unless you've upgraded).
[1] https://www.twilio.com/docs/libraries/python/migration-guide