Questions tagged [documentation]
Use this tag for questions about the now phased out Stack Overflow Documentation feature. For posts relating to help pages (documentation for the site itself), use [help-center] instead.
1,375
questions
2
votes
0
answers
31
views
Tab usage in Q-A section as in Documentation [duplicate]
I've found out that I can use tab while writing Examples in Documentations. It makes writing code easier while writing a question or answering one. Are you planning to implement this in Q-A too?
2
votes
0
answers
17
views
"Actions" should link to the actual edit [closed]
The "Actions" tab of a tag's Dashboard is pretty informative, however I can't actually see the edits that are being referenced without going to the topic page, and scrolling and clicking to find the ...
2
votes
0
answers
40
views
My Docs edit caused a server error [closed]
On the Swift "Subscripts" topic, I created a draft to move its only example to a different topic, thus deleting the topic. I got an error when trying to submit the draft, and now I get a server error ...
2
votes
0
answers
45
views
Proposed change doesn't show any changes in diff view [closed]
When reviewing a change in a PowerShell topic I don't see any any changes in the diff using any of the views:
It will only allow comments for the "run commands" example so I assume that was the ...
2
votes
0
answers
89
views
Can we have granular approval/rejection? [duplicate]
It's probably not that simple to implement but it would greatly help us out emptying the current backlog of changes.
user story
user A submits 2 examples X and Y on the same topic
user B knows ...
2
votes
0
answers
39
views
Can't approve edit to move examples and delete topic [closed]
I'm trying to approve this edit, which moves the examples in the "Blame" topic to the "Blaming" topic, then deletes the Blame topic.
Clicking "approve" on the target ("Blaming") seems to have worked, ...
2
votes
0
answers
53
views
How can update I syntax as a list of one-liners? [closed]
Syntax must be formatted as a list of one-liners
I'm struggling to get over this error while updating a syntax such as this:
subscript(index: Int) -> Int {
get {
// return an ...
2
votes
0
answers
31
views
Cannot view draft in documentation ("Oops! Something Bad Happened") [closed]
I created a draft for some initial content on the gruntjs tag documentation. Now I cannot access that draft. I go to the documentation page for the tag, see the entry under "My Drafts", and click on ...
2
votes
0
answers
37
views
How do I "select at least one draft to publish"? [closed]
I was working on some documentation and started a topic that a user had requested. I'd written up three examples and then submitted for review. Then, I realized that I wanted to add a bit more to ...
2
votes
0
answers
32
views
Proposed changes “suggested” by moderators have a display bug [duplicate]
A moderator deleted a topic, and the edit summary shows this:
It should either say:
STATUS: Trusted to make this change without review
or:
STATUS: Approved by animuson ♦
Trusted to make this ...
2
votes
0
answers
29
views
Show my when my improvement requests have been acted on [closed]
https://stackoverflow.com/users/57159/ian-ringrose?tab=documentation&sort=requestsforimprovement lets me see all my improvement requests, but does not show if a request has been acted on. This ...
2
votes
0
answers
35
views
"Proposed changes" page doesn't remember markdown diff render setting [closed]
The title says it all, really.
When opening a proposed change, the markdown diff view never seems to remember my "side-by-side" choice.
For example, take this proposal.
Chose a different diff ...
2
votes
0
answers
39
views
Tag that already exists in documentation [closed]
In the documentation, I have noticed a case of another tag for documentation of a language that already has its own tag.
Main Swift documentation
Additional Swift documentation
Topics can be ...
2
votes
0
answers
25
views
Restrict the review queue restrictions for users [closed]
This edit of mine finally got accepted. But since the approving user just has a few reputation points, while not even having ANY SCORE in the topic C and just even a score of 2 for C++, I don't feel ...
2
votes
0
answers
22
views
Favourite tags in documentation [closed]
It'll be a good feature if there would be a set of user favourite tags in the documentation, like there is in main Q&A part of SO, so that the user could directly go to his favourite documentation ...
2
votes
0
answers
85
views
SO and Documentation reputation (and badges) are calculated twice on Area 51 [duplicate]
The question is about Stack Overflow reputation, so I decided to ask it here.
On Area 51 my reputation from several Stack Exchange sites is showing this way:
I thought that Stack Overflow ...
2
votes
0
answers
85
views
Oops! Something Bad Happened, while accessing a documentation [closed]
After editing a documentation, I got a conflict with an approved change notification, Whenever I try to access the documentation, I get a 500 Internal server error.
Bellow I have attached a Wireshark ...
2
votes
0
answers
93
views
Request Topic vs Create New Topic [closed]
When try to create a non existing topic, users are given two options: 'Request Topic' and 'Create New Topic'. What is the difference between these two options? Which one should be opted in which ...
2
votes
0
answers
35
views
Documentation first topic layout (style) is messed up [closed]
I am trying SO documentation at work (Firefox ESR 38.5.0) and the first topics of each tag in documentation is messed up:
I did not have this problem when browsing SO documentation at home (latest ...
2
votes
0
answers
85
views
How to version-tag documentation that applies from some version onwards [closed]
MySQL's JSON data type was only added in v5.7.8, which is fairly recent (5.8 isn't yet out). Consequently, somebody has proposed adding the MySQL 5.7 version tag to the topic about it.
This version ...
2
votes
0
answers
40
views
Proposing a Documentation tag for a synonym leads to a 404 page [closed]
Steps to reproduce:
Go to documentation.
Click "Propose a New Tag" (the blue button along the right side of the page near the top).
In the "Tag" text box, type msil.
Note that two choices appear, ...
2
votes
0
answers
38
views
Should the java-8 tag exist at all in documentation? [duplicate]
I found the java-8 tag and figured its purpose was to cover features introduced in Java 8, so added a new topic "Lambda expressions" and an introductory example.
This has been flagged as a ...
2
votes
0
answers
29
views
Internal server error when rejecting draft [closed]
I tried to reject this draft, because the topic was not about debugging.
Rejecting caused a POST request to /documentation/javascript/drafts/13573/reject-draft, which responded with a 302 Found ...
2
votes
0
answers
20
views
Added topic approved or not? [closed]
Today I created a topic "Loops" in the Bash tag (https://stackoverflow.com/documentation/bash/drafts/35489).
I got a notification that this was approved, however I does not show up in the Bash tag. ...
2
votes
0
answers
28
views
Old comments from previous draft can't decide upon their existence [duplicate]
On this change suggestion: https://stackoverflow.com/documentation/proposed/changes/42237
I've added a comment on an old revision of this. Now, he retracted the original revision and resubmitted (...
2
votes
0
answers
35
views
Comments on proposed topic changes behave oddly on revision [closed]
You can comment on topic changes. But last night, I encountered something very strange. I was commenting on a change, and the person behind the change was revising the edit. But every time he did so, ...
2
votes
0
answers
29
views
Documentation feature-request: Prevent duplicate topics server-side [closed]
There are several feature requests already related to handling duplicate topics or making it easier to avoid them, but I have a more Draconian request: I think that the app should make it impossible (...
2
votes
0
answers
29
views
Next button after review task in documentation [closed]
Can the developers add a button to go to the next review task? Now I must return to the dashboard and select a new one. That is a long way to review a few review tasks.
2
votes
0
answers
38
views
Can't use superscripts in Parameter tables in documentation [closed]
Using the <sup> tags inside a Parameter table causes this error to appear when submitting an edit for review:
Parameters must be formatted as a two column table
For example, O(n<sup>2&...
2
votes
0
answers
50
views
Tag wiki edits linking to Documentation [closed]
It was brought to my attention by this tag wiki edit that some users are submitting edits solely to add links to the corresponding Documentation topic from the tag.
This is, I think, superfluous ...
2
votes
0
answers
23
views
Inline code is not properly formatted after horizontal rule, in documentation examples [closed]
The following footnote is shown correctly, with an inline code snippet:
But if I insert a <hr>-rule after the main text, the inline code stops being displayed as such:
2
votes
0
answers
21
views
Clicking title of Documentation revision opens edit page with no way to close the editor [closed]
After clicking the title of a Documentation revision (example) I'm taken to a page that shows the editor with no obvious way to close it.
2
votes
0
answers
27
views
Broken Documentation change suggestion [closed]
This suggested change cannot be accepted or rejected ("An error has occurred during submission...") and has no change highlights. I am not sure what is broken, but it seems that something is...
2
votes
0
answers
25
views
How do I ask for a PyQt5 example in documentation? [closed]
I saw an example in PyQt4. How can I ask for the same in PyQt5?
2
votes
0
answers
50
views
Flag inappropriate documentation requests & tags [closed]
https://stackoverflow.com/documentation/wordpress/topic-requests/2555
On this the op requests a topic explaining
"what wordpress plugins are out there and which is best for my website"
I don't want ...
2
votes
0
answers
47
views
Documentation flags should support Markdown [closed]
I just noticed this on one of the examples that I flagged:
Is there a reason why Markdown isn't supported here? Granted, the comments in the image above might not be the best example (I personally ...
2
votes
0
answers
66
views
Is it possible to give feedback to a documentation? [closed]
I myself lack the understanding of Fragments. And I went to the documentation to see if I can help myself understand, and the creator said nothing about what Fragments are, when they should be used. ...
2
votes
0
answers
35
views
Editing a proposal by you takes up too much place on the screen [closed]
I made a proposal for an example on Documentation today. In a few minutes, I got a few comments telling me to make a few changes in my proposal. I agreed with all the changes, and went retracted and ...
2
votes
0
answers
23
views
Multiple proposed changes for different examples in the same topic [duplicate]
Currently, if multiple examples are edited within the same topic, they count as a single proposed change. Since they all have an independent edit button, I think they should be considered as distinct ...
2
votes
0
answers
18
views
"Other" text box limit too small when rejecting edits [duplicate]
When rejecting an edit in documentation you are given the option of selecting "Other" and then typing in an "Other" reason. This box states the following explicitly:
A problem not listed above. Be ...
2
votes
1
answer
43
views
How to add Syntax and/or Parameters to an already created topic in Documentation? [closed]
I have explored the new Documentation and found a topic with a few nice examples. However, I felt that some examples needed some more explanation about syntax and stuff then I went to add info to ...
2
votes
0
answers
19
views
Adding Example Bug on Chrome [closed]
Adding a new example on any topic creates 2 new posts. If I want to save the intended example I have to delete the other one.
2
votes
0
answers
32
views
Review pending edits when editing a documentation example [closed]
When attempting to editing an example with pending edits, we get notified about the fact that there are that there are pending drafts and also a possibility to view them.
Is there a way to quickly ...
2
votes
0
answers
31
views
How to change a name of a tag? [closed]
Currently, I see prolog, but it should be Prolog instead.
2
votes
0
answers
23
views
Versions keeps being override by changes [closed]
Here I removed the versions for GO JSON.
A different change, that did not impact the versions was then approved (probably it was created before my change was approved) and it override the versions ...
2
votes
0
answers
18
views
Multiple types of versions for a single topic [closed]
It would be helpful if topics supported multiple versions. e.g. for Spring MVC, it would be fantastic if we could tie a topic or example to both the version of Spring MVC (e.g. 4.2.x), and also to the ...
2
votes
0
answers
47
views
Documentation bug: Can't use less-than, greater-than signs in syntax block [duplicate]
When I try to write something with those characters like <Type> while editing the syntax section the wrong error shows up (Syntax must be formatted as a list of one-liners), and I can't publish ...
2
votes
0
answers
17
views
I lost access to a topic I wrote and submitted for review but discarded accidently [closed]
I completed a topic "How to add Multiple SSH keys on a client" to be part of "Documentation (beta)". I wrote it, selected it for review but then tried to edit something later and accidentally selected ...
2
votes
0
answers
16
views
Ability to lock documentation topics (as for questions) [closed]
It would be nice at some point to be able to lock certain topic to prevent changes from users with low reputation, as it already happens for certain questions.
The reason is that basic topics tends ...
2
votes
0
answers
26
views
When a documentation topic is approved, and it has multiple examples, the latest activity is flooded by them [closed]
All of these lines correspond to a single topic that gets approved. I think it'll be better that if a topic is approved, only the last line appears in the activity, probably with how many examples ...