Regarding content organization and quality ...
- Too many examples [...]
- Examples being edited to be very large [...]
A related problem is too much dodgy content getting through review.
Tweaks to the rep and review mechanisms can help, but part of the problem comes from a lack of consensus within each tag community about what the docs should look like. I think we need per-tag discussions for this, since the right length for an example, the right number of examples, etc. will vary from tag to tag and topic to topic.
An example from the R tag: We should discuss whether we need "data types""data types" as a topic, and if so...
- what relationship the topic should have with other topics
- which data types should be included
- what examples should look like
- which example should be pinned
- whether to split up existing examples (like "numeric" into ints and doubles)
- whether to merge existing examples (like "numeric" with "int64")
Current tools:
The planned "focus" section sounds promising for clearing up ambiguity on a per-topic basis, but not for issues that span multiple topics. Also, disagreements over what the focus should be seem likely, and discussions about them shouldn't be buried in comments on edits.
Improvement requests presuppose that we've all agreed about how things should be organized. But I could request splitting up some examples, while someone else comes along requesting merges. We have no way of hashing it out nearby the doc itself, since improvement requests cannot be commented on.
With chat rooms, it's hard to follow a discussion and find it later; and chat lacks Q&A features that we probably want in such discussions (like comments, voting, and code blocks within a post).
People are using the Q&A format here on meta for this already. Wouldn't it be better to have that organized per-tag?
Anyway, I like all the changes so far and how y'all are approaching this.