Questions tagged [documentation-proposals]
For Meta questions and discussion relating to proposals for new Documentation. For questions about proposed changes, use [proposed-changes] instead.
80 questions
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 ...
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 ...
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 ...
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:
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 ...
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 ...
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 ...
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 ...
-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 ...
-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 ...
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 ...
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".
...
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 ...
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'...
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 ...
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 ...
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 ...
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 ...
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 ...
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 ...
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 ...
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 ...
3
votes
0
answers
39
views
Expand the topic request interface [closed]
Topic requests need more information
Browsing through the topic requests doesn't give much guidance towards what people actually wanted a topic for.
I was looking in C# out of curiosity to see if ...
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 ...
7
votes
0
answers
79
views
Display for Topic Request Dismiss vote? [closed]
I just dismissed a topic (this one) because it already exists. Everything fine so far, but after linking the existing topic and clicking ok, nothing happened - at least not visible. I wasn't sure if ...
2
votes
1
answer
98
views
Documentation new topic: Where did my draft go? [closed]
I requested a new topic in the Ruby language documentation, then proceeded to write a full set of examples for it in the draft.
But now I can't figure out how to get back to that draft, and I can ...
5
votes
0
answers
70
views
How about a "[doc:<topic-name>]" like syntax? [closed]
As you may know, the [tag:<tag-name>] syntax is used to automatically link to the corresponding info page of a tag. That means
See the many questions tagged [tag:elephants] to learn more.
is ...
3
votes
0
answers
75
views
Express an interest in the Tag Documentation [closed]
According to https://stackoverflow.com/help/documentation-add-tags
In order for a tag to have documentation, it must have at least 500
questions and 10 committed users with at least 150 ...
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 ...
23
votes
0
answers
288
views
Increase reviews limit [closed]
Just now, I got this error message again, when voting on a proposed draft:
Basically, I'm out of votes.
I don't know what the daily limit is, but I hit it (at least) 2 days in a row now.
I'd ...
6
votes
0
answers
136
views
Approving half-rejected proposals should be more difficult [duplicate]
Small proposal for the proposals: a proposal should need at least 1 more approvals than rejections to be considered approved
Maybe proposals reaching 10 approvals and rejects could be locked, and ...
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:
2
votes
0
answers
20
views
Why does rejecting a documentation change lead to an error? [closed]
I tried to reject this change on UILabel.
I chose "Other" with the text: No text changes were made in this change.
I always get this error message:
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
...
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'...