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
91
views
Is it acceptable to use documentation examples for pointing out/proving/confirming certain things? [closed]
I've been thinking of writing a documentation example which's purpose is to prove/confirm a certain statement, but I'm unsure if this is considered "acceptable" (even after reading the FAQ) or is what ...
2
votes
0
answers
40
views
Don’t include the edits I’ve suggested in the review count [closed]
I noticed that if you suggest a change to a Documentation example, in the review section the number of pending edits will include yours, however you will be unable to review your own change. Should ...
2
votes
0
answers
59
views
Alignment issue in the Documentation examples [closed]
In the documentation example section (Click on + Add Example icon on any documentation page), there are two minor alignment issues.
The Markdown Editing Help icon has extra back ground color.
The ...
2
votes
0
answers
42
views
Sort Documentation tags based on Favorite Tags [closed]
Would it be possible to have documentation tags float to the top of the list based on our SO favourites?
2
votes
0
answers
53
views
How to recover a discarded documentation draft after it had been submitted for review? [closed]
I spent quite a while documenting something and submitted it for review.
I then wanted to make a change and it didn't work like I wanted, so I said to discard it thinking it meant the subsequent ...
2
votes
0
answers
51
views
Topic outline: "Show 14 more examples, 1 more sections" [closed]
Whenever you view a topic that has too many examples and exactly one special section (for example), the bottom of the topic outline says:
Show 14 more examples, 1 more sections
"Sections" shouldn'...
2
votes
0
answers
70
views
Reject documentation changes if the change reason / comment is not clear enough [closed]
Based on this documentation review, I want to initiate some discussion. In this review we have the following,
Deletion of a topic, with the reason of Handling improvement requests
The change (the ...
2
votes
0
answers
24
views
Allow filtering history to only show changes within a specific section [closed]
The history link under each example filters the topic history to only those changes that touch the respective example. The other sections, however, don't have such a feature, and the history link at ...
2
votes
0
answers
33
views
Description Section in Documentation [duplicate]
Something I noticed about documentation was that descriptions are often included in examples. It seems to me that there should be a section specifically for describing what something is. To me it ...
2
votes
0
answers
62
views
Why Did I Get Reputation From This Documentation? [duplicate]
I noticed I got a +2 rep boost from this Documentation post. I don't see my username on it anywhere and I'm having a really difficult time remembering what, if anything, I contributed. Am I just not ...
2
votes
0
answers
37
views
How do I move a Documentation topic to a question? [closed]
I've browsed around Docs.SO a bit, and I found a lot of things that would live better under a question that already exists on the Q&A site. There are often more and better answers to be found in ...
2
votes
0
answers
40
views
Documentation review - Invalid state [closed]
I have run into an issue when reviewing a proposed change where it says it cannot be approved because it is in an invalid state. If this is the case shouldn't it be rejected by the system ...
2
votes
0
answers
33
views
Can't Reject a New Topic request for Docs [duplicate]
I get an "An error occurred, Please try your action again" on trying to reject this edit.
I tried:
"copied content"
"other"
Both do the same... Also, attempted it from the queue (that's how I got ...
2
votes
0
answers
40
views
Submitting Documentation edit fails, but error message is missing [closed]
After using button "submit for review" I get a red field over the "brief explanation" textfield without any error hint and the action has not succeeded.
This happens only with all examples of a ...
2
votes
0
answers
63
views
An error has occured [closed]
I am receiving this error while trying to improve draft.
2
votes
0
answers
28
views
Documentation Topic Review and duplicate topics [closed]
I spent some time over two weeks ago writing a nice detailed topic in a fairly out of the way Documentation tag, containing sample code, diagrams and explanations on all the examples.
This hasn't ...
2
votes
0
answers
67
views
How long it takes for `Topic` to be approved, and who approve it on Stack Overflow Documentation Beta? [closed]
I suggested a topic in the Stack Overflow documentation beta, but it is still shows the status as 'Awaiting approval'.
I would like to know how long it takes for a topic to get approved?
And who ...
2
votes
0
answers
27
views
Recent achievement popup reputation broken with upvoted answer linking to own example in documentation [closed]
When I open the "Recent achievements: [...]" pop-up, I get the following:
Which is a +50 on a SO documentation example, which has currently a score of 0 (1 downvote and 1 upvote I think), but in my ...
2
votes
0
answers
37
views
Documentation Topics for Experimental-like Questions on Stack? [closed]
I was filtering through some of my old questions when I stumbled upon a question that I answered myself.
Context of the question: I had a curiousity, and I experimented. I then posted my results as ...
2
votes
0
answers
49
views
After dismissing topic it is still listed in Documentation topic requests, but not my dashboard [closed]
I have dismissed Delphi topic and I my Documentation dashboard shows 5 topic requests.
But when I go to Delphi Documentation directly it still lists 6 topic requests.
Now, it is not clear to me ...
2
votes
1
answer
42
views
Dismiss requested topic as 'Already exists' does not allow to select an existing topic request as a reason [closed]
It only allows selecting existing topics.
However if a similar topic request has already been made, I think this should count as a duplicate as well, as I do not see why there should be multiple ...
2
votes
0
answers
33
views
"Handle improvement request" lost when draft edited [closed]
I edited the expression trees example yesterday. When I first edited, I clicked "Handle improvement request" and then clicked submit. Later, I finished the draft and clicked submit again. On the ...
2
votes
0
answers
34
views
Pipe in documentation tables [duplicate]
The pipe character cannot be used in tables on Documentaion. The pipe character is used for defining the columns but there seems to be no way of escaping the pipe characters, even not with backticks. ...
2
votes
0
answers
35
views
Notes within the Documentation Editor [closed]
Whilst not finalised, the latest piece of CSS documentation to be written about Specificity in CSS uses the letters "A", "B" and "c" to refer to its different levels. To conform with this, when ...
2
votes
0
answers
43
views
Markdown rendering bug with inline code in Remarks [closed]
Something is wrong with the Markdown rendering in this topic's Remarks:
Source:
<h2>When to use the weak-keyword:</h2>
The `weak`-keyword should be used, if a referenced object may be ...
2
votes
0
answers
25
views
Is it actually intended that Documentation's contents morph in their form? [closed]
What I'm actually percieving about documentation is, that the biggest problem is, any one has his own mindset about how the perfect description of an topic should be looking like.
As far as I have ...
2
votes
0
answers
90
views
A suggestion for helping to deal with Documentation rep-farming [closed]
After reading a question about weighted Documentation approval votes, and the quoted segment from today's Documentation Update, I feel that all small edits should be listed for review, with a few ...
2
votes
0
answers
38
views
Proposed edits with tables [closed]
I was just going to review this proposed edit, and I went to side-by-side view, and BLARGLE!!!! What is this madness? The tables seem to overlap, at least in google chrome on linux. Here is an image:
2
votes
0
answers
38
views
How should duplicated information between "new in <version>" topics and feature-specific ones be handled? [closed]
While reading through some content in the c# tag on Documentation, I noticed some worrying duplicated information.
In the "C# 6.0 Features" topic, one of the examples is a very thorough explanation ...
2
votes
0
answers
36
views
Shouldn't it be possible to link two requestet topics in the documentation together? [closed]
When I checked the Android requested topics I came across:
QR Code reading and the use of the Zxing QR & Barcode scanning lib.
Personally I'd use ZXing to explain the QR Code reading, so it would ...
2
votes
0
answers
31
views
Handling improvement request but not showing on the change page [closed]
I handled an improvement request, then, after a comment from another user, I edited my Example before it was approved/rejected. And now it is approved but it is disassociated from the improvement ...
2
votes
0
answers
13
views
Editing two separate sections in two separate sessions merges changes [closed]
I performed two separate edits to this topic in two separate editing sessions, but they got merged into one. Did I do something wrong, or if not, I would like to suggest that we add a feature to keep ...
2
votes
0
answers
52
views
Area 51 incorrectly counts total rep from Stack Overflow [duplicate]
Not sure this one belongs here, but since Documentation belongs to Stack Overflow I'll post it here I guess.
It gives me 2x the 7,158 from Stack Overflow, one time from Documentation and one time ...
2
votes
0
answers
57
views
How to post an example for documentation [closed]
I'm trying to post a new example on documentation when I wrote significant material to post and added some images Than I tried to submit that example. I pressed Submit for Review button but an error ...
2
votes
0
answers
27
views
Bug with edit history on documentation topic involving removal/moving in the past [closed]
The edit history for this topic is an "Oops" page.
When the edit history is accessed from the individual example in quesiton, it works OK.
2
votes
0
answers
24
views
How to undo approval or rejection in Documentation? [closed]
Is it possible to undo an accept or reject vote on proposed changes in the documentation?
Seems like there is no way to handle miss-clicks.
2
votes
0
answers
35
views
Feature Request: sections to better organize documentation [closed]
Big, major topics have lot of contributors and editors and many sub-arguments.
Currently an editor / contributor can decide to follow proposal or topic request for a single tag, as a whole. When ...
2
votes
0
answers
33
views
Seemingly blank edit on Docs [duplicate]
This edit on the Documentation Beta has no visible changes at all:
https://stackoverflow.com/documentation/proposed/changes/64827
I tried to reproduce the same situation and found I was able to ...
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:
2
votes
0
answers
51
views
Type shown on mouseover [closed]
Disclaimer: this is only appealing for dynamically typed languages.
It would be cool to have the return and parameter types of the signatures in the syntax section appear when you mouse over the ...
2
votes
0
answers
36
views
Devastating hangups when trying to improve documentation [duplicate]
I've tried to improve an item in the c tag area, namely https://stackoverflow.com/documentation/c/507/files-and-i-o-streams#t=201607280403587709618 and every time I try to do so in Firefox (47.0.1) or ...
2
votes
0
answers
45
views
How can these documentation edits get in conflict? [closed]
Today I was notified that my edit in windbg versions
is in conflict with this approved edit of windbg debuggers
How is that possible? IMHO they have nothing in common except the topic they are in.
2
votes
0
answers
44
views
Moving documentation example to another topic - Error [closed]
I've added a proposed change examples for time measurement in Debugging topic of Javascript language Documentation. link: Javascript.Debugging
Fellow user pointed out that a similar topic (with only ...
2
votes
0
answers
22
views
Not linking to existing API docs but to to Docs.SO? [closed]
People start to link to Docs.SO instead of linking to existing, official API documentation of high quality (example).
I don't think this is something we should encourage. Docs.SO must not replace or ...
2
votes
0
answers
29
views
Created date should also be included [closed]
There is data mentioned in any topics or review request. I think we should include created data also to check when request was made for new topic.
Initialy what happened with me is i have created 3-4 ...
2
votes
0
answers
26
views
Can't access some topics [duplicate]
For about 5 days now I have not been able to access some topics.
https://stackoverflow.com/documentation/ruby/640/control-flow
https://stackoverflow.com/documentation/ruby/288/hashes
https://...
2
votes
0
answers
21
views
Proposed Changes to a Topic should be deleted when the Topic is deleted [closed]
When I look at the list of Proposed Changes on the JavaScript Language Documentation tag, I see a proposed change for a Topic, ECMAScript 2015, which has since been deleted.
There is nothing I can do ...
2
votes
0
answers
41
views
Documentation: Lost Changes and "Already Reviewed" [closed]
I recently typed up a significant amount for the Introduction to Elasticsearch documentation, but a bunch of micro-edits got merged ahead of it. I was keeping track of them and updating my example to ...
2
votes
0
answers
39
views
Fighting with the editing interface (or: Show me what I requested to see) [closed]
I find myself fighting with the editor interface a lot. I like to open the current iteration of the topic in a seperate tab besides the edit proposal I am currently working on. However, when you have ...
2
votes
0
answers
48
views
Markdown help in documentation [duplicate]
With documentation, tables has been introduced to nicely structure information. I'm having some trouble escaping | character inside table cells while I was editing Selectors topic in CSS tag.
If use ...