53
votes
Accepted
Everyone can contribute to documentation but I "cannot commit to this proposal"
Everyone can contribute to documentation that exists.
If documentation does not exist for a particular topic, it has to be created first, and we want to make sure that it is worth creating. That ...
Cody GrayMod
- 243k
38
votes
Accepted
Limit the Docs review votes for lower rep users
I agree this is a problem.
Some of the design aspects were highlighted in other posts as well, with one suggesting that not only the review aspect, but the collaborative edit aspect, was also a ...
29
votes
Accepted
The things that drive me nuts about documentation
This is very helpful feedback. Let me take the items one-by-one:
I left a comment to another question:
I've been envying the Wikipedia Main Page a lot lately and not just for Docs. It seems to me ...
23
votes
Accepted
User who resubmits rejected drafts
If you feel that a user continuously submits bad suggestions/drafts I would flag for moderator attention, explaining the situation and linking to the accepted and rejected proposals. A moderator will ...
13
votes
Accepted
Syntax must be formatted as a list of one-liners
Looks like the problem is the code formatting. Use inline code instead:
- `git pull [options [<repository> [<refspec>...]]`
13
votes
Accepted
Please introduce threshold to post documentation requests
Update: These are now thoroughly blacklisted. If they figure out how to get past that, I'll blacklist them further. Kudos to Adam Lear for implementing the blacklist.
(detailed answer follows)
Well, ...
11
votes
Feature request: seeing the reputation on documentation review
If you are reviewing an edit, you should pay attention regardless of the reputation of the editor. Otherwise, what's the point of reviewing the edit at all?
If we wanted reputation to be used as a ...
8
votes
Documentation: Someone approved my topic and then rewrote my examples
It looks like you proposed this change back on the 1st... But then retracted it a few minutes later.
Because it was retracted, no one could approve it. So it sat there in limbo, waiting for you to ...
6
votes
Accepted
Why can the version table only have two columns?
Version tables already support multiple columns, that error message should be tweaked. I'll get that done in the next build.
The actual requirements are:
at least two columns
the first column must ...
6
votes
Limit the Docs review votes for lower rep users
Agreed. Tag score and tag badges are supposed to be indicative of a user's knowledge in that category, so review power should be weighted based on them, with new privileges unlocked at higher levels. ...
5
votes
Accepted
Error: Trying to commit to Telegram Documentation Proposal
This is a recent bug, stemming from code deployed a few days ago.
There was a null reference exception occurring when trying to create a new documentation tag (aka DocTag). Because you are the last ...
5
votes
Accepted
Documentation changes by a diamond moderator go undetected
Turns out we weren't setting ReviewableDate (which is the timestamp of when a proposed change went into review) on self-approved changes. That's been corrected and data fixed up retroactively, so self-...
4
votes
Accepted
Versions section should not allow submission without a table
As of the latest build, an edit that modifies the versions section can only have tables (and headings, if the are multiple tables) as the top-level elements in their markdown.
Old drafts and whatnot ...
4
votes
Accepted
Cannot review retracted and revised/resubmitted Doc proposal
This will be fixed in the next deploy. Retracted drafts that are subsequently resubmitted will be reviewable by the users who reviewed them pre-retraction.
4
votes
Let us do more to Documentation tag proposals besides watch silently or acquiesce
On the one hand, there are a bunch of proposals that are obviously not going to go anywhere.
On the other hand... My experience with burninate-requests here has convinced me that folks are often ...
4
votes
Accepted
How to document multi-language tags in SO documentation, e.g. Spark?
I would take a look at what has been done for the .NET Framework Documentation. Mostly the examples use C#, but there is a Getting started with .NET Framework section that illustrates some of the ...
4
votes
How can a peer-review let this happen?
If you look at the side-by-side markdown view, you can see he added comments in various code blocks:
If the reviewers were in this mode, they might have thought he was adding some more information ...
4
votes
Accepted
Prevent highly upvoted topic or example from being removed
I already finished this quest. Here's a trivial solution to your problem.
Go to your reputation tab;
Switch to post mode;
Check "show removed posts";
Expand every day;
Find a day with a big ...
4
votes
Accepted
Can a user commit to a documentation proposal if their best answers is zero scored
No, zero doesn't count as positive in this case. a.Score > 0 is correct.
4
votes
Accepted
Documentation new topic: Where did my draft go?
You can find your current drafts at
https://stackoverflow.com/users/current?tab=documentation&sort=topicdrafts
3
votes
Accepted
Opt-out of a Documentation Proposal
I fixed the problem by creating an alias from codeigniter-3 (and codeigniter-2) to codeigniter in Documentation. We'll need to look into putting this in the hands of the community if these cases ...
3
votes
Should documentation examples' highest vote be the most generic example? If it's voted too much what should I do?
Generally... I don't agree with your thesis that Docs should cover best-case-scenario problems rather than those people struggle with in reality. To uncover the latter, we rely on votes and requests ...
3
votes
Accepted
Empty review queue showing "1 Proposed Change"
We had a bug where it was possible for a topic draft not to get marked as reviewed if it was deleting a topic, but the topic was already deleted by the time the proposed change with that draft was ...
3
votes
Accepted
What does it mean to commit to a documentation proposal?
This, among many reasons is why we updated our Tag Proposal page in a recent redesign.
Here's a screenshot of what the page now looks like, for one of the proposed tags on Docs -
Among other ...
3
votes
What does it mean to commit to a documentation proposal?
I have committed to a lot of documentation proposals, and my Stack Exchange inbox (stackexchange.com/users/[myuserid]?tab=inbox) now receives all:
Improvement requests
Proposed changes
Topic requests
...
2
votes
How to downvote, close or flag proposal documentation tags
I couldn't agree more. Add also to your list antlr and antlr4. Documentation already has a feature that can handle versions internally.
As a participant in private beta I can say that there are some ...
2
votes
Accepted
A Proposed Change is broken
I'm marking this as status-norepro, but I see there is still a weird display problem with that change right around here:
It looks like the issue is with some HTML in the proposed change:
### ...
2
votes
Accepted
Error page when opening specific proposed change
Looks like this got fixed some time since July. :)
Probably somewhere around when we switched to /review for Documentation changes.
2
votes
Documentation suggest a number of changes
First things first: a bit of terminology. Usually, on Stack Overflow, there are questions and answers, both of which you can edit. On Documentation, however, there are topics, which contain one or ...
Cody GrayMod
- 243k
2
votes
Accepted
Add a link to the Documentation page in the Documentation: Proposed Changes review queue
A link should now be available for newly created topics, once they are approved.
Only top scored, non community-wiki answers of a minimum length are eligible
Related Tags
documentation-proposals × 80documentation × 74
feature-request × 32
bug × 24
discussion × 22
status-completed × 14
support × 11
documentation-topics × 7
review-queues × 7
tags × 2
comments × 2
reputation × 2
proposed-changes × 2
documentation-editor × 2
diff × 2
design × 1
suggested-edits × 1
review-audits × 1
badges × 1
rejected-edits × 1
spam × 1
markdown × 1
help-center × 1
moderators × 1
status-norepro × 1