Keep the documentation up to date with the changes in the Azure Portal. At the moment, the portal is in a newer state than what the documentation shows.
Also, provide better examples of how and where to use the differing authentication options for different scenarios. At the moment, I am really struggling to get a simple demo working for a new feature because the documentation is out of date, and I don't understand which method to use to authenticate.
For documentation feedback please leave it directly on the document itself. We have a feedback system enabled at the very bottom of every document.