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.
461
questions
23
votes
0
answers
285
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 ...
13
votes
4
answers
278
views
Documentation: Where do libraries belong? [closed]
Currently the R topic is a mix of base R documentation and package documentation. Its seems as though most people are posting package specific documentation within the R tag. However, separate tags ...
13
votes
1
answer
301
views
What is the daily review queue limit for docs? [closed]
I just got told I cannot review anymore topic proposals today:
What is the daily review queue limit for Documentation?
12
votes
2
answers
126
views
Duplication in documentation, example C# vs .NET Framework [closed]
I can see duplication in C# Language and .NET Framework.
An easy one to spot is the LINQ topic.
How do we handle duplication like that? (this can apply to many other documentation / topics)
11
votes
1
answer
349
views
Skipping review based on tag badge not working [closed]
According to the 4th August update:
Users with a silver or gold tag badge (from Q&A) will skip review when they make an edit to that tag's documentation
I have a silver vba badge in Q&A, ...
10
votes
2
answers
193
views
I still have a question about grammar in Documentation's "Still have a question?" [closed]
Previously on Stack Overflow Meta, there was a grammar bug relating to a and an before topic names.
Now, the article has been removed fully, and that is bad grammar. Here's an image with the issue:
...
9
votes
0
answers
86
views
documentation - "Mark as favorite" button really lacks [duplicate]
I really need a "star" button for some documentation example. Today I looked through many python pages and examples and found dozens of them that are of use for me.
And since I treat StackOverflow ...
9
votes
0
answers
131
views
Newly created documentation topic and example completely disappears [closed]
About an hour ago, I created a new topic named "Classpath Resources" within the Java documentation section. Then I added an example named something like "Finding Resources with Class.getResource()".
...
7
votes
1
answer
73
views
Improve wording on no-review edit 'approvals' [closed]
Apparently I'm "trusted to make this change without review"
Without going into how much incredibly poor judgment is required to trust me on anything, the wording seems awkward. Instead of "Approved ...
7
votes
1
answer
134
views
Mortarboard badge from Documentation reputation? [closed]
Just curious - I participated in Documentation Beta, and now the rep that I'm getting since Documentation has been moved into Stack Overflow has exceeded 200 per day.
Does that rep count towards the ...
5
votes
1
answer
199
views
Tutorial-style List for Documentation? [closed]
The Problem
In my opinion, Docs.SO is currently a good, standard-reference-style documentation. It works well to achieve its purpose as an updated, community-based, on-request source of answers.
So ...
4
votes
0
answers
123
views
Is a link only answer pointing to Documentation an answer? [closed]
Can I limit my answer to a link to documentation?
If the answer is positive won't it degrade the quality of the Q&A site? How do I write a good answer? says:
Provide context for links
...
3
votes
1
answer
160
views
Who can delete a documentation example? [closed]
With documentation running wild, I joined the fun and added an example. I later checked back and noticed that someone had deleted it. Since the user is neither a moderator, nor a gold-tag-badge ...
3
votes
0
answers
58
views
Documentation: moved an example - the topic is now bugged/unavailable [closed]
If you look at the current CUDA tag in Documentation, there are two topics:
Seeing the 'hello, world!' as an example of introduction to CUDA I tried to move the only example within "Hello, world!" ...
2
votes
1
answer
115
views
Ability to make suggested tag edits seems to be disabled [closed]
Background
The creator of this meta question recently made suggested edits to some tags on Stackoverflow.
The suggested edits consisted of creating links to the new SO Documentation feature where ...
2
votes
0
answers
58
views
Long example title overflows into the buttons [closed]
There is an example in https://stackoverflow.com/documentation/python/484/date-and-time which the title is so long it is broken into two lines. We see that part of the text are covered by the edit, ...
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, ...
66
votes
6
answers
2k
views
What if documentation took its content from Stack Overflow Q&A? [closed]
When I need to look up a concept, I don't go to the official documentation or to Stack Overflow Documentation. I go to a Stack Overflow Q&A.
This is a radical change, but I'll toss it out there. ...
102
votes
5
answers
1k
views
How does Stack Overflow Documentation differ from official documentation? [closed]
I have gone through some posts about Stack Overflow Documentation (1, 2, 3), and I
haven't found a clear, simple answer to the question: do we really need it?
As I see it, there are currently (at ...
84
votes
4
answers
3k
views
Who is the target audience for documentation? [closed]
I am a semi-frequent contributor to the C++ Language documentation section. I am currently dissatisfied with the "Hello World" example.
As of the time of writing, it is over 600 words and contains ...
13
votes
2
answers
1k
views
How to use the documentation archive? [closed]
Now you have removed documentation and placed a dump file here. It is really not more than a dump, in JSON format. Does it include any of the bitmaps, screenshots etc? I don't think so, from a quick ...
52
votes
0
answers
553
views
What did I just commit to? [closed]
I was just looking at the Lucene proposal on documentation and was considering committing, but I wanted to know what that actually means.
I figured that, as on Area 51, perhaps it tells you what you ...
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 ...
56
votes
1
answer
827
views
Why was my Topic+Examples deleted without explanation? [closed]
Yesterday I spent several hours creating a Topic with 6 Examples showing how to drag shapes on html5 canvas.
Today my Topic was deleted without explanation by moderator animuson.
The now deleted ...
27
votes
1
answer
285
views
Creating a topic which already has good official documentation [closed]
I wonder how can I procced with this situation. The tag kendo-ui have just been open for contribuitions in Documentation and I was about to create a topic, where I want to approach the Templates ...
23
votes
2
answers
1k
views
What's going on with Documentation this month? [closed]
My colleague, JNat, has been posting regular updates about feature requests that we are working on. That's been working out pretty well and we've undertaken a major new direction in Documentation, so ...
16
votes
1
answer
230
views
Languages and the environments where they're used should have different tags [closed]
Right now the JavaScript section of Documentation is having a lot of topics and examples regarding one of its environments, the browser.
Node, which is another JS environment has its own section.
...
99
votes
0
answers
867
views
Why am I earning documentation privileges? [closed]
In the past day I've earned two privileges for a feature that doesn't exist any more:
Documentation Review:
Documentation Comments:
Both of these link to help documentation which is still active.
...
42
votes
1
answer
471
views
What is the purpose of voting on Documentation? [closed]
On the Q&A site, voting lets me distinguish between good and bad answers (also, questions).
What purpose does voting have on the Documentation site?
It's probably not the same purpose - the ...
31
votes
1
answer
210
views
How do I view vote count split in documentation? [closed]
Currently, I cannot see the vote counts (up/down) in documentations. Is this another privilege?
24
votes
1
answer
456
views
Should we close all meta questions tagged with Documentation? [closed]
I see a large number of questions in the Close Vote review queue on Meta Stack Overflow that have the documentation tag. They are flagged as off topic with the "can no longer be reproduced" reason.
...
22
votes
1
answer
249
views
Guidance for using Syntax and Parameters in documentation [closed]
I would like to see some guidance on how to use the Syntax and Parameters sections in documentation.
I was just now looking at a review that seemed to combine syntax and explanation. While I had the ...
19
votes
1
answer
364
views
Content attribution in the era of Doc.SO's erasure
All user-provided content on SO is given under the terms of the CC-by-SA Creative Commons license. Among other things, this allows copying, but only so long as you provide attribution to the original.
...
46
votes
0
answers
898
views
Documentation downvote count shade-of-red is too bright [closed]
Q&A:
Docs:
I suggest changing the shade of red in Docs to match that of Q&A.
22
votes
0
answers
114
views
Please include the ability to cross-reference existing Docs within Documentation [closed]
We've already started coming across some issues of duplicate information being presented a number of times. In this example, the Flask framework uses generic JSON requests, and so there are some ...
12
votes
3
answers
272
views
To what extent are third-party libraries on topic in Documentation? [closed]
As I asked in the comments in this change request, what is on-topic and what is off-topic as far as examples explaining how to use third-party libraries on Documentation? From my comment: "[W]here [do ...
9
votes
0
answers
77
views
Should documentations like 'android' and 'android-gradle' be merged together? [closed]
The issue
We currently have android documentation and android-gradle documentation as separate documentations. Both document android-gradle to some extent.
What is the Stackoverflow guidelines for ...
8
votes
1
answer
401
views
Are answers to too-broad questions a good fit for Docs? [closed]
As we are preferred to give examples in documentation, would the answers in these questions be suitable?
This question had been closed (as too broad - which is actually quite true), re-opened (on ...
6
votes
0
answers
62
views
In documentation someone should have to provide a reason for dismissing a request for a topic improvement [closed]
When the community requests improvements. I can dismiss them without providing a reason.
In the image below there are three requests.
I think doesn't make any sense
I think has been handled
I think ...
45
votes
1
answer
274
views
Add "Duplicate" as rejection reason for Proposed Changes [closed]
Currently, a Topic Request may be dismissed because the Topic already exists:
As you can see, there is even a field to paste a link to the existing Topic.
I have found that it is not just Topic ...
41
votes
2
answers
752
views
What level of experience should we assume for readers of SO Documentation? [closed]
I was making a couple of updates to the HTML documentation and realised that I wasn't clear on exactly who the audience is meant to be. If it's introductory material how introductory should it be? ...
35
votes
2
answers
284
views
How do moderators fit into documentation? [closed]
(they get folded in half until they fit?)
In Q&A, moderators have active participation in the content of the site - whether it be locking posts, admonishing those that refuse to follow the ...
32
votes
1
answer
1k
views
Why am I getting rep for doc changes I had nothing to do with? [closed]
Today I received +2 rep for a doc change 4 different times, on topics I have contributed nothing to. You can see this in my reputation history. Each one of these is from an edit (that I did not ...
32
votes
4
answers
628
views
Let's organize the SQL documentation [closed]
Documentation has been in public beta for about a week, and some users have pointed out a few issues with the SQL docs, so before things get too unwieldy let's address some of the issues. I mentioned ...
30
votes
1
answer
244
views
Documentation badge awarded twice? [closed]
I guess sunsetting documentation is going into the final stretch, as I was just awarded the Documentation badge for "Earned at least one badge for contributing to Stack Overflow Documentation", as per ...
27
votes
0
answers
258
views
Trying to understand Stack Overflow Documentation [closed]
Someone will probably point me to a readme/blogpost, but I don't really understand Stack Overflow documentation. Maybe it should be renamed Stack Overflow Examples?
Documentation usually ...
27
votes
4
answers
617
views
MATLAB documentation: what's the purpose? [closed]
I'll be short and clear - MATLAB already has a great(!) documentation. I have learned almost everything I know in it directly from the official documentation, and they are exhaustive, clear, give good ...
26
votes
1
answer
419
views
How can I discuss existing topics in Documentation? [closed]
We can easily discuss requested topics (by adding comments), but when a topic has been created we can only request for improvement.
But I have something to say or I'd like to ask something about the ...
23
votes
2
answers
414
views
Seven separate topics explaining C# streams: how should they be combined/managed? [closed]
The c# tag on Documentation (not including the .net tag) has seven separate topics that all attempt to explain streams. Three of them have the exact same name (with different contents), most of them ...
21
votes
1
answer
242
views
Should I be adding as many examples as possible to a documentation topic? [closed]
I noticed there's an example which seems out of place on documentation but it's clearly getting up voted. Let's imagine the topic was C hello world
I'm just guessing but I think most programmers? ...