The Stack Overflow Documentation of [youtube-api] is, at this point, not very advanced, to say the least.
Obviously I can't speak for you, but I personally always try to consult the official documentation provided by the creator/maintainer of a service or product (that is, if I am confident that said entity is providing high-quality and most importantly up-to-date documentation, which is the case with Google in my opinion).
That makes me wonder if we really need separate documentation for the YouTube APIs on Stack Overflow, since virtually all of its possible contents are probably already covered by Google. They provide guides to getting you acquainted with the concept of the APIs, code samples for multiple programming languages and a complete reference for all API endpoints and their parameters, among other things.
I feel that documentation on Stack Overflow could not add any considerable value to the existing, official documentation and would instead lead to a fragmentation of information. That comes with the risk of the service being updated and the official docs along with it, with the Stack Overflow docs becoming obsolete when not updated accordingly.
I therefore propose to either close/discontinue Stack Overflow documentation for [youtube-api] or to only have it contain content that is not yet covered by the official documentation. Either way, I would refer users to Google Developers whenever possible.
I understand that the Documentation tour page justifies Documentation with 'prioritizing good examples', but again: I don't think it's necessary in this particular case since Google has already done a good job at that.
EDIT: I'd like to add that I would still be committed to helping this specific documentation become of use to Stack Overflow users, whatever the outcome of this discussion. All within my possibilities.
Amendment 1
I was asked in the comments whether I am advocating only keeping documentation for tags where an official documentation is either not present or insufficient.
I wasn't sure about this when I posted the original question. The intent was to collect other people's thoughts, primarily, of course with my own opinion being voiced as well. Considering the points brought up so far (especially that Stack Overflow Documentation should be regarded as a cookbook), I, personally, am now in favor of keeping Documentation for tags like [youtube-api].
My preference is to follow @Braiam's cookbook advice, while still trying to keep redundancy at a minimum. That means, focusing on very specific problems that are not already explained by Google (see this comment). This results in a follow-up question. The documentaion tour states:
Documentation is divided up by its subject matter, the library, language, framework, etc. that developers are using.
Therefore, how should documentation for [youtube-api] be structured (i.e. by subject matter, by language, etc.)?
PS: advice on how to proceed with this new matter (opening another question or continuing in this thread?) greatly appreciated!
(End of Amendment 1)
On a side note as someone who is kind of a regular at [youtube-api], I know for a fact that many questions with that tag can be solved by simply looking at the API reference. Because that's what I do when I answer those questions.
Interesting:
- What's Documentation for? @ MSO
- Docs is broken: Writing Docs we actually need @ MSO
- How do we remove a Documentation tag? @ MSO
- Official YouTube Data API documentation @ Google Developers