I think we can address this with the documentation team. GSoD 2019: Improved REST API Documentation - #44 by dkayiwa