Skip to main content
1 of 2
Gordon
  • 316.6k
  • 24
  • 20

As per my comment:

Can someone please clarify the scope of the docs please. The blog post says examples are king, but what I see right now is people adding more or less random topics. What is the point of reiterating the Q&A of the main site? I would understand if docs was for user created API documentation, but I dont see why we need a Stack Overflow in Stack Overflow.

I have checked the various preceeding Meta Posts and it's not clear to me what should go into documentation and what is better left for the main site. It's too vague for me right now.

We have quite a lot of good canonical answers on the main site by now. Especially the basic stuff, like how to create an array for example or basically every git command out there, has been covered extensively on the main site. Why repeat that?

Also, how do I decide between supplying a self-answered Q&A on the main site or writing it into the docs? Is there some guideline when to choose which?

Finally, is there any such thing as a too broad topic? Or off-topic that should not go in the docs? I could obviously write a lengthy tutorial about how to handle XML with PHP, but that would then really be that: a tutorial - something that is deemed off-topic for the main site. What about duplicate content?

TL;DR: I miss a clearly defined boundary what should go into docs and what shouldn't.

Gordon
  • 316.6k
  • 24
  • 20