Updating the REST API doc

Maybe it is just me, but I find the current REST API doc very minimal. While it is good at listing each end point and describing the various available params, it fails at explaining HOW it should be used.

My latest frustration was with cloning reports from one workspace to another as described here: https://docs.microsoft.com/en-us/rest/api/power-bi/reports/clonereport#request-body I was getting 400 errors (without any description) until I realized that my issue is that the dataset must already exist in the target workspace. Some my think it is obvious, but since it is not explicit in the doc (actually the fact that it is an optional params may even make us believe that it is automagically copied over) it creates confusion.

So my point is, would it be possible to put the doc on Github and let the community keep it up to date?