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,380
questions
4
votes
0
answers
34
views
Autofill link text when linking to Documentation [closed]
When using the Documentation linking feature, it should provide you with good default link text. Namely, the title of the example/feature.
In this case, i would like for it to autofill the link text ...
8
votes
1
answer
133
views
Why are people getting Documentation Pioneer badge in December 2016? [closed]
The help page for Documentation Pioneer badge says:
Contributed 3+ substantive pieces of documentation in the first
month of documentation.
This should mean that the badge should no longer be ...
13
votes
0
answers
356
views
Deleted example hardly noticable in proposal diff [closed]
When I deleted an example and copy-pasted into a new one to reorder the examples (I second the motion to add a feature that does that), I noticed that in the proposal diff window, the deleted example ...
3
votes
0
answers
47
views
Merge documentation tags jQuery, jquery-plugins, jquery-selectors [closed]
The jquery-selectors tag is already a topic in the jQuery tag, so it would make sense for these to not be separate.
I think that jquery-plugins will either be way too broad, trying to cover the scope ...
3
votes
1
answer
51
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 ...
7
votes
1
answer
88
views
Is there a bug with Versions tables editing? [closed]
I am trying to edit the versions table that already exists on the HTML documentation.
After doing my amends I received the following error:
Versions section only allows headings and tables
So I ...
9
votes
1
answer
255
views
Finding missing documentation [closed]
I was just answering a question on SO about a JDBC related question,
Perfect! I wrote up a nice long example with comments and details on Docs.. now just to find it..
I have gone through all of my ...
11
votes
0
answers
83
views
How is Documentation meant to be searched/found? [closed]
In its current form, SO Documentation revolves around examples that are organized into topics. Each topic has no more than 13 examples, and examples have a maximum length. Given this criteria, how ...
494
votes
13
answers
13k
views
The dawn of Documentation: a solstice update [closed]
Normally Kevin does these updates, but I wanted to take an opportunity to talk about how Documentation is doing from my perspective as a community manager. For the last 3 years or so, building ...
183
votes
6
answers
1k
views
Documentation should be elitist [closed]
This post was inspired by the "Is Documentation failing?" question, but it's something I've been thinking about for the system.
The fact is: The idea of world-editable, world-moderated content makes ...
25
votes
1
answer
79
views
Can I link to a post from Q&A in documentation? [closed]
I was planning to improve this example, which talks about Identifiers and IdentifierNames in JavaScript. I was wondering, is it okay to link to an answer of mine, this one, that explains this in ...
-39
votes
1
answer
144
views
The reputation points for writing documentation should be increased and there should be a verified documentation option [closed]
Most of the time creating a new documentation topic requires more time than a simple answer. So in my opinion the incentive for writing documentation should be increased and there should be a way to ...
1
vote
0
answers
63
views
Why was my topic deleted from documentation? [duplicate]
I had earlier posted a topic on docs about constructing loops. There was general help in finding initial condition, iterative construct, and termination condition along with one example. It was ...
34
votes
1
answer
232
views
Why isn't my progress shown for Documentation reviews? [closed]
When I do review on questions and answers, I can see my progress toward a badge. But for Documentation reviews, I have no progress shown.
Why is my progress toward a badge not shown for Documentation?...
3
votes
1
answer
52
views
Changes to introduction missing from activity tab [closed]
Changes to introduction sections (e.g., this one) do not appear in the tag's activity tab.
The only place they could be found is in the topic's revision log, but that makes it much harder to audit ...
7
votes
1
answer
208
views
Creditor badge awarded incorrectly? [closed]
Most questions about the creditor badge seem to be about not getting it. I got it, but only because somebody else added a link to an example to my answer:
This feels like a bug to me. Even though it ...
6
votes
1
answer
505
views
Why has my proposal disappeared? [closed]
I noticed when I made a proposal to a documentation item, I didn't see that it was rejected or approved and it just disappeared.
Since contributing something is an effort the author of any change ...
0
votes
1
answer
50
views
Is there a way to see why documentation was deleted? [duplicate]
I had created a documentation topic somebody else had requested.
This topic on shortcuts in Android Studio
I went back today to add the mac part, but it had been deleted. I'm not so much bothered ...
36
votes
1
answer
404
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 ...
4
votes
1
answer
76
views
Bug in the Preview/Display of Wiki Introduction Markdown [closed]
I've noticed something strange when I edit the wiki intro of a concept, for instance: https://stackoverflow.com/documentation/backbone.js/8178/sync
When editing the intro the preview function ...
285
votes
9
answers
5k
views
Is Documentation failing? [closed]
Are there any stats for Documentation about the activity in a specific tag? I have observed that a niche tag like MATLAB is pretty much dead (last action on Dec 2nd). I personally lost interest in ...
2
votes
1
answer
99
views
Documentation - Can't edit many sections of draft [closed]
Issue with documentation editor for drafts.
When I click on "pencil" icon near the Introduction section (or Introduction in draft's summary panel), it doesn't seem to work. The same thing is ...
3
votes
1
answer
229
views
Multi-line formatting in Syntax section of Documentation [closed]
I've started browsing the Documentation for some of my favourite tags and am looking to contribute. As a soft start to ease myself in, I came across the GROUP BY topic within the sql tag, which said ...
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 ...
-14
votes
1
answer
158
views
Getting Renovator badge? [closed]
How do I get the bronze badge Renovator?
This badge belongs to the "Documentation Badges" group.
5
votes
1
answer
250
views
Image isn't correctly rendered [closed]
I just tried editing a remark in docs. I added a picture. The preview looked fine. When I saved SO is some how parsing the text wrong (I guess that assumes it saved exactly what I entered and is only ...
8
votes
0
answers
179
views
Is poor spelling/grammar a suitable reason to reject an edit in Documentation? [duplicate]
I came across a proposed edit today to a topic which added an introduction where there wasn't one previously, but the quality of the written English was poor to the extent that it may not be readable ...
85
votes
1
answer
1k
views
How to report users spamming in Documentation requests? [closed]
I came to notice Documentation is getting spammed by users.
But there is only an option to dismiss a documentation request. Nothing to flag the request as spam, or I could not find anything in the ...
46
votes
3
answers
2k
views
Should people who've never asked or answered a question for C be allowed to review C documentation changes? [closed]
I was looking at recent changes in the C documentation, and came across the review https://stackoverflow.com/documentation/review/changes/113746?filter-tags=c.
The change was made by someone with a ...
24
votes
1
answer
270
views
Docs.SO linked upvotes drowns rep report from SO answers [closed]
I noticed when an answer links to a Documentation.SO post, and that Docs.SO post gets upvoted, suddenly all rep acquired from that answer is "swallowed" by the Docs.SO linked topic in the achievements ...
3
votes
0
answers
44
views
Show intro-only edits in "Activity" on the Docs dashboard [duplicate]
I figured I'd try out the new Introduction section and edited one into a few topics. I can find the edit history on my profile page; but it is not listed on the tag's dashboard.
I'm guessing this is ...
2
votes
1
answer
51
views
Problem saving edits, results in inability to view topic [closed]
Similar to this question, I tried creating some "Remarks" in a topic and got an empty red box as an error message when I tried to submit the change. Watching the requests in the browser inspector, I ...
7
votes
1
answer
138
views
Banner on proposed changes that have a reject vote for "copied content" [closed]
Often when I leave comments on proposed changes, it's to inform other reviewers that I've caught plagiarism. For instance:
Copied from: https://channel9.msdn.com/Forums/Coffeehouse/254267-Vista-File-...
20
votes
1
answer
199
views
Increase the character limit for Documentation introductions [closed]
As per the documentation update of november 29th, a "Introduction" section was added for documentation topics.
Since I "abused" a pinned example to serve as an introduction, on a topic I wrote, I ...
3
votes
0
answers
56
views
Better improvement requests options for Documentation [closed]
The current options for Improvement requests are only the following:
All of them come out as somewhat negative. I simply wanted to let the author know of some improvements that I felt that could ...
2
votes
1
answer
96
views
Same reputation for documentation and document improvement? [closed]
I have observed there is similar reputation (+2) for
Writing the document and
Improving the document.
Ideally the document author spends lot of time to investigate and write a nice document. Also ...
-2
votes
1
answer
73
views
Combine Spring Documentation? [closed]
When searching Documentation for Spring, thirteen separate tags come up, four of which are proposals. There is no federated way to search among all those topics contained under these tags for how to ...
8
votes
1
answer
217
views
Documentation drafts are not saved [closed]
I just lost a draft of a piece I was putting together for C++11 / OpenGL and RAII idiom. I have no idea of what happened to it. I don't know why it showed up in the 'examples' as I was working on it, ...
2
votes
1
answer
68
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-...
5
votes
0
answers
75
views
Is this a typo in the Stack Overflow Documentation's "Add Introduction" Placeholder? [closed]
Recently, I tested the new Topic Introductions that have been added in the Stack Overflow Documentation. When adding an introduction to the topic (by clicking the plus button next to the "Introduction"...
3
votes
0
answers
37
views
Should we break down the iOS documentation? [closed]
As I look through the iOS documentation, it seems a little cluttered. There are topics on Delegation, Anything you can imagine from UIKit, Core Location and there are even ones on NSDate and NSTimer.
...
283
votes
0
answers
4k
views
Documentation Update, November 29th [closed]
Well, November 2016 sure was a month that happened.
Now that we're on the other side of the US election and holidays (and the team is back at work) it's time for an update on Stack Overflow ...
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
50
views
How can I suggest that Documentation tag be merged with another? [closed]
In the documentation section, there are 2 tags that are almost the same.
playframework (11 topics)
playframework-2.0 (1 topic)
In the question section of Stack Overflow, it makes a little more sense ...
8
votes
2
answers
92
views
Error editing remarks subsection in documentation [closed]
I was having a look at the C# Expression Trees documentation page.
I noticed the Creating expression trees looked a bit strange - in particular the 'compiler magic code bock expression tree API' ...
2
votes
1
answer
131
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
137
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?
1
vote
1
answer
61
views
All documentation badges missing from next badge picker [closed]
Note: This question is similar, but only covers the documentation beta/pioneer badges. I can understand why they aren't included in this picker.
I'm interested to know why none of the documentation ...
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?