You can use the schema to figure out the valid values and descriptions for some of the values, so that might help. I agree that a technical reference would probably help since reading the schema isn't fun.
Doesn't shock me that it's mostly GitHub search since most of our docs are hosted on GH:
Thanks for the feedback, we point to the schema that is pulled directly from the product, but I agree that we can do a better job at documenting it. Will forward it to our Azure content people.
PS: UserVoice is the best way to channel site feedback to us - I check it daily and open bugs based on suggestions there :)
+1 on UserVoice. My team (Application Insights) actively reads UserVoice and the MSDN forum, and I know other teams are just as proactive about reaching out to users.
Doesn't shock me that it's mostly GitHub search since most of our docs are hosted on GH:
https://github.com/aspnet/Docs
https://github.com/dotnet/docs
You can always add a request to the docs UserVoice: https://msdocs.uservoice.com/forums/364242-general-site-feed...
Azure also has its own docs UserVoice: https://feedback.azure.com/forums/217534-documentation