Skip to main content
added 153 characters in body
Source Link
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. It was often mentioned that the documentation is supposed to be an extension to the Q&A site, but my impression is that it is competing with it instead.

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.

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.

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. It was often mentioned that the documentation is supposed to be an extension to the Q&A site, but my impression is that it is competing with it instead.

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.

Source Link
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.