Skip to main content

Questions tagged [documentation-proposals]

For Meta questions and discussion relating to proposals for new Documentation. For questions about proposed changes, use [proposed-changes] instead.

Filter by
Sorted by
Tagged with
15 votes
0 answers
114 views

Proposed change review should link competing proposals [closed]

I'm sure that I'm not the only one who has had a proposed change clobbered by another change. Currently proposed changes do not cite if 'accepting' them would clobber other proposed changes. Would it ...
2 votes
0 answers
148 views

Proposal to revise "Some questions are still off-topic" listed items to be expressions that result in off-topic questions [closed]

In the help center, the headline: "Some questions are still off-topic ..." is expressed as a scoped list of off-topic questions. However, some of the listed items under this headline express ...
2 votes
1 answer
59 views

Selecting all versions beginning from a particular version [closed]

In documentation, suppose I am adding an example for a C++ topic that came into being C++11 onwards. Now how do I go about selecting the versions? Option 1> Select C++11, C++14, and C++17 Cons: The ...
58 votes
1 answer
633 views

What can we do about robo-reviewing on documentation? [closed]

I found a case of robo-reviewing in documentation. A few examples: https://stackoverflow.com/documentation/proposed/changes/50840?draftId=43301 has discussion, someone rejected, he approved https://...
14 votes
0 answers
244 views

The buttons in review audit are misplaced [closed]

This proposed change is looking like this: The buttons are a little bit on the wrong side for some reason.
2 votes
0 answers
47 views

Don't hyperlink whole content of "copied content" if it starts with http [closed]

When you include some text information in the "copied content" field in the Documentation review, it doesn't get hyperlinked. So far so good. But if you start the content with a link, everything will ...
8 votes
2 answers
510 views

What does it mean to commit to a documentation proposal? [closed]

What exactly does it mean to commit to a documentation proposal? The only information given is: "Once there are 5 committers, the community will be able to document all (some_language_name) topics". ...
12 votes
1 answer
239 views

Blocking a proposal on documentation [duplicate]

Is there a way to block a proposal, essentially launching a counter vote to not add another topic? Laravel for instance has their main documentation at /laravel, a second one for a minor version and ...
22 votes
0 answers
555 views

Rejected change as defacing, while there isn't any defacing [closed]

I proposed this change. I've just improved some aspects in Creating a New Project example and added another example: Setting up AVD (Android Virtual Device). It was rejected by two users with this ...
9 votes
1 answer
123 views

Error page when opening specific proposed change [closed]

I'm in the "Proposed changes" tab of the JavaScript topic, where I try to open this proposed change: It redirects to the following error page: https://stackoverflow.com/error?aspxerrorpath=/...
3 votes
0 answers
55 views

Redundant newlines in Documentation proposed changes reviewer list [closed]

On the Proposed Changes page in Safari on macOS, each reviewer takes a newline, which makes the page a bit weird looking:
14 votes
2 answers
747 views

Everyone can contribute to documentation but I "cannot commit to this proposal" [closed]

I'm part of the team developing the JSON Schema specification. I was going to suggest to some of the team that we document some aspects of the specification on the Stack Overflow documentation ...
3 votes
1 answer
52 views

Documentation: Created new topic, one example disappeared [closed]

On C++ Language I created a topic called Resource Management. I added an introduction and two examples, and submitted it for review. When I clicked on my proposal to check on it it only showed one of ...
0 votes
0 answers
38 views

Undo documentation proposal commit [duplicate]

I have committed this documentation proposal but now I realize that I shouln't. crm tag y quite open and its definition is quite generic so I don't think a valuable documentation could be added to ...
0 votes
0 answers
43 views

Review Queue for Document error [duplicate]

Quite a few times now I will go to the review queue and it will show there are a positive amount of changes needing review for documentation. BUT when I click then it will say the queue has been ...
102 votes
1 answer
874 views

The things that drive me nuts about documentation [closed]

These are some of the things that make me wince every time I enter the documentation side of the site, that I think a decent number of people would agree with. I'd like to see what people think about ...
2 votes
0 answers
33 views

Documentation Review Error on Approval [closed]

After clicking "Approve Change" for change request: https://stackoverflow.com/documentation/review/changes/117297 I am given an error: An error has occurred - please try your action again. This ...
22 votes
1 answer
400 views

Documentation changes by a diamond moderator go undetected [closed]

Diamond moderators may need to remove or edit content if needed, without review. That is fine. But their changes do not appear in tab=proposedchanges, subtab=approved. [At least I assume they should ...
18 votes
1 answer
195 views

Versions section should not allow submission without a table [closed]

I was browsing documentation and noticed there's a Notepad++ documentation section. Being a frequent user of Notepad++, I went to see what other users have added so far. I started by checking if they'...
36 votes
1 answer
407 views

Please introduce threshold to post documentation requests [closed]

We are receiving documentation requests from new Stack Overflow members with a reputation of 1 that look like this: I ran this through Google Translate, and it's clearly SPAM. Please, can someone ...
2 votes
1 answer
69 views

How to document multi-language tags in SO documentation, e.g. Spark? [duplicate]

Let's say I want to help document Spark. Now Spark framework has APIs in multiple languages including Java, Scala, Python having the same functionality. SO Documentation already has two tags apache-...
3 votes
0 answers
69 views

Why can't I see this documentation proposed change in review? [closed]

Situation: So I've been going through the reviews for today, and I cannot help myself getting really annoyed by this 1 proposal that has been here for at least an hour, and isn't visible for me: But ...
2 votes
1 answer
137 views

Error: Trying to commit to Telegram Documentation Proposal [closed]

I saw I can join the Telegram Documentation Proposal. I clicked the big button commit, and this happened: I went back to https://stackoverflow.com/documentation/telegram/commit Clicked Commit again ...
12 votes
0 answers
139 views

Why is a documentation proposal with 5 committers still in staging area? [duplicate]

I proposed documentation for esp8266. This proposal was accepted by 5 committers a couple of days ago, but the tag is still not available. What is missing to start documentation on this tag?
3 votes
1 answer
315 views

How can a peer-review let this happen? [closed]

Just look at this link in a "Documentation Proposed Changes". How can a peer-review approve such changes? I also went to the profile of this user and saw that he gained around 80 reputation in 2 ...
14 votes
1 answer
211 views

Documentation Alias Request [closed]

As per bluefeet's answer in this question: If you have tags that need to be aliased, then create a Meta post asking for it. Can we alias the following to vba please: excel-vba access-vba word-vba ...
-2 votes
1 answer
99 views

Prevent highly upvoted topic or example from being removed [closed]

Currently, topics or examples removal seems to be quite easy. Many highly upvoted topics or examples are removed easily. Personally, I think that the Docs review queue isn't really effective. 100 rep ...
4 votes
0 answers
65 views

Revamp the “commit page” for documentation [closed]

Since there are many questions that ask what you commit to when you commit to a Documentation tag, it seems that “committing” isn’t the best description for what’s happening. Instead, I think there ...
-15 votes
2 answers
98 views

Feature request: seeing the reputation on documentation review [closed]

When reviewing proposed changes for Stack Overflow Documentation, wouldn't it be good to see the reputation of the submitter? That would allow reviewers to pay more attention if the submitter ...
7 votes
1 answer
119 views

Add a link to the Documentation page in the Documentation: Proposed Changes review queue [closed]

Currently, it doesn't seem to be possible to get to the Documentation topic from the Documentation Review Queue: https://stackoverflow.com/documentation/review/changes/97118 For example, in ...
70 votes
2 answers
568 views

Limit the Docs review votes for lower rep users [closed]

So if you look at the Docs review history you'll see lots of the following I'm not judging the reviewer or his reviews (his block was on one page). I only offer it as an example, since there are ...
16 votes
1 answer
173 views

A Proposed Change is broken [closed]

This proposed change is very broken: I can’t even approve or reject. In chat, Quill pointed out: Reading the HTML it seems that first level ul inside examples blocks break the top layer ul of ...
9 votes
1 answer
98 views

Cannot review retracted and revised/resubmitted Doc proposal [closed]

I was looking over proposed edits on Docs, and I saw one that was good material, but poorly arranged. I left a comment to that effect. You can't see it now, maybe because of this bug, but it was "This ...
42 votes
0 answers
533 views

Reject, retract, revise, resubmit, rejected? [duplicate]

So, I rejected this edit (pic) because it contained incorrect information (Math.LN10 isn't 2.718, it's 2.302). After that @Alex Filatov retracted, fixed this mistake, and resubmitted (pic) it. I ...
0 votes
0 answers
64 views

Stats for documentation proposed changes [duplicate]

Great - a new review queue for documentation's proposed changes was turned on last night. So, we can reduce input box noise now. I know it's BETA and this question isn't for a problem but a feature ...
22 votes
1 answer
160 views

Empty review queue showing "1 Proposed Change" [closed]

As a image says more than 42 words: It appears there are secret changes being suggested ;-) When there are proposed changes, the count is also incorrect:
18 votes
0 answers
563 views

"You proposed this change to yesterday" what does that mean? [closed]

I was checking a documentation which I had updated yesterday and I noticed this: It says You proposed this change to yesterday The "to" should be removed: You proposed this change yesterday
3 votes
0 answers
49 views

Documentation edit submission improvement [closed]

Whenever I go to the edit mode in the series of documentation examples once in editor mode the main page goes back to the first entry. I have to manually go back to the example I was working on. Let'...
1 vote
1 answer
41 views

Documentation suggest a number of changes [closed]

I am new to documentation, I was trying to improve upon some existing answers but there was a dilemma. Say I have 5 suggestions to be made on the same question, once submitted either they all are ...
4 votes
0 answers
83 views

Clarity in Docs tour as to rep limit for accepting changes [closed]

There doesn't seem to be anywhere on the Docs site that explains how accepting changes work, especially with regards to reputation. After asking for a while on the Docs chat, someone pointed out that ...
1 vote
1 answer
33 views

"Dismiss" button bug for topic-requests without description [closed]

Here is how it look in Firefox 48.0.1: For each topic-request which has no description (when right after title goes requester info), border does not hover Dismiss button. But when topic-request ...
7 votes
0 answers
85 views

Is anybody moderating documentation and where can I see flags that I flagged in it? [closed]

I am wondering if anybody is moderating documentation? I have flagged several examples, topics and so on, but I don't see any action being done. When I go to my flag-summary page I only see flags on ...
8 votes
1 answer
182 views

Opt-out of a Documentation Proposal [closed]

I've opted-in for a Documentation proposal a while back that I believe should never be made, which has gained more support since. (I must also add, the sidebar did advertise a tag for it! I blame big ...
14 votes
0 answers
132 views

Improve diff view readability in suggested Q/A edits and proposed documentation changes [closed]

Looking at "side-by-side (markdown)" diff views is a bit of a headache, when it comes down to an entire Q/A/topic/example being rewritten. Take this proposed change, for example: Since it's ...
3 votes
0 answers
122 views

Encourage answers that link to official documentation [closed]

TL;DR: Discuss/propose methods to promote good links in addition to upvoting answers. Discussion Should there be a badge or some other award for good answers that provide links to primary sources as a ...
2 votes
1 answer
69 views

Can a user commit to a documentation proposal if their best answers is zero scored [closed]

In trying to garner support for a Documentation Proposal against a fairly niche tag, I'm using the Stack Exchange Data Explorer to identify potential committers through the following Potential ...
37 votes
1 answer
783 views

User who resubmits rejected drafts [closed]

I've been watching the Proposed Changes in the JavaScript tag and at least one user keeps submitting poor changes. I then explain why they aren't good changes and reject the draft. On more than one ...
5 votes
1 answer
254 views

Documentation: Someone approved my topic and then rewrote my examples [closed]

I requested a new topic for the documentation for the Ruby language: Struct I also wrote three examples showing how to create them, access them and how to add methods to them. The topic was ...
13 votes
1 answer
138 views

Give credit for authors of an original draft [closed]

Background So, we encountered just this situation: Documentation addition rejected yet added by user that rejected it An user made a largely great proposal with a few things not perfect. Thus, the ...
3 votes
1 answer
100 views

Should documentation examples' highest vote be the most generic example? If it's voted too much what should I do? [closed]

To me documentations are different from SO questions they should first address the most applicable scenario and then from there answer questions that are less common. If they answer corner cases then ...