Please, please, PLEASE improve the Bamboo REST API documentation!

The vast majority of Bamboo's API documentation is completely unusable. Very few of the calls have any description of what they do, any additional parameters are usually lacking in description as well, and the "expand" menus (that should contain feedback examples) are nearly always empty. Without ample documentation, it's extremely difficult for me to know what functionality Bamboo's REST API has.