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
1
answer
66
views
Documentation review : Providing feedback [closed]
I did not find option to add comment on code examples documented by other user.
In this post :
https://stackoverflow.com/documentation/design-patterns/1331/strategy-pattern
Everything is lifted ...
2
votes
1
answer
79
views
Pinned example in document topic is overlapping with text [closed]
Seems like a small bug with pin alignment on topic examples in our new documentation section. Here is the link to the relevant document.
Just thought about giving the heads up.
2
votes
1
answer
34
views
"viewig" typo in Documentation help [closed]
Trivial, but on the Documentation Votes help page, at the very bottom:
Dismiss an improvement request by viewig a topic, and clicking dismiss in the expanded improvement request pane.
Just an FYI ...
2
votes
1
answer
51
views
Documentation should have a compatibility section [closed]
Something to say which version of browser, languages, etc. support the feature the example refers to.
2
votes
1
answer
40
views
"Peer Review" badge description is HTML-encoded in the iOS app [closed]
The apostrophe in the description of the new documentation badge "Peer Review" is HTML-encoded:
This doesn't happen on the website, so it's probably a bug in the iOS app.
(I don't know if this ...
2
votes
1
answer
42
views
The “action description” for a proposed change is incorrect sometimes [closed]
If I edit to change a topic’s versions from “All Versions” to some (but not all) of the versions:
the “action description” of the edit changes:
I would expect this to say something like “removed 1 ...
2
votes
1
answer
32
views
Link/move documentation to tag for [android-databinding] [closed]
I hope this is the right place to ask.
Is there a way to link or maybe move the Data Binding Library documentation to the tag android-databinding?
As of now, the tag page for [android-databinding] ...
2
votes
1
answer
64
views
Review of documentation change isn't recorded [closed]
When reviewing documentation, I got this change to review and I approved it. But after reviewing it, I went into the history tab and I couldn't see my review in there. And then when I went back in the ...
2
votes
1
answer
101
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 ...
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 ...
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 ...
2
votes
1
answer
57
views
Shortened links to topics and examples in Documentation [closed]
So here's the link given to topics in Documentation:
https://stackoverflow.com/documentation/tag-name/topic-id/topic-name
And here for examples:
https://stackoverflow.com/documentation/tag-name/...
2
votes
1
answer
44
views
Fix the UI for initiating a Docs edit so improvement requests are not erroneously handled [closed]
Most of my improvement requests are "handled" erroneously thanks to what I hope is a UI oversight.
Here's the usual pattern:
Helpful user arrives at a Topic
They have a look at improvement requests
...
2
votes
1
answer
172
views
Capitalize the freebsd documentation tag [closed]
From what I see, the most popular tags in Documentation (like Android or JavaScript Language) are stylized properly.
Is it possible / what's the procedure to change freebsd to FreeBSD in ...
2
votes
1
answer
50
views
Pagination links in original revision history of moved example broken [closed]
The pagination links in the original revision history of a moved example are pointing to a 404 status returning URL.
See e.g. https://stackoverflow.com/documentation/php/revisions/194?exampleId=730
...
2
votes
1
answer
103
views
What to do when documentation contribution is deleted several times? [closed]
I would like to discuss about what occurs on piece of documentation about std::string Tokenize.
From the edit history we can see :
my initial contribution add a simple example based on std::getline
...
2
votes
1
answer
100
views
Major contributor status granted for creating a Topic? [closed]
All of my edits on this contributor breakdown show that I was simply shuffling examples:
And yet I have "Major" contributor status in the table below it. Is this just because I created the Topic? I ...
2
votes
1
answer
76
views
Something wrong with Documentation interface [closed]
There is an article which I wanted to remove as irrelevant to the section and to its own title.
But out of two attempts I failed with both.
First time it seems I deleted a topic that was requested ...
2
votes
1
answer
54
views
Question up-vote is not crediting 5 points for documentation link [closed]
For the questions, which have been up-voted with a documentation links, I am getting a reputation of 15 points instead of 10 points (only once). Further up-votes resulting into credit of 10 reputation ...
2
votes
1
answer
37
views
Unable to approve change to documentation, whole topic, concurrent changes [closed]
There are two concurrent (don't know whether it's relevant) changes to this page:
https://stackoverflow.com/documentation/proposed/changes/77179
https://stackoverflow.com/documentation/proposed/...
2
votes
1
answer
106
views
"Duplicate" or "copied" examples in Documentation [duplicate]
Some examples are in different topics, but they're exactly the same. For example, if there's a topic on scoping and a topic on functions, both would have a function scope example.
When adding a new ...
2
votes
1
answer
36
views
Where should introductory material for Documentation tags/topics go? [closed]
I am quite confused on where to put introductory material for a given topic or tag.
Here, I have created a page for Trees under the algorithm tag, with an Introduction example. However, I could very ...
2
votes
1
answer
69
views
Bug in Activity Tab Pagination [duplicate]
Pages 79 - 83 of the Activity Tab in JavaScript tag is blank while the pages 102 - 109 in C# Language tag is blank
This seems to also occur in other tags.
2
votes
1
answer
73
views
Documentation: Appropriate granularity for examples? [closed]
Should examples cover an broad idea exhaustively with many snippets of code, or cover a specific idea with one or a few?
For example, in the broad Java topic Streams, an example "Creating a stream" ...
2
votes
1
answer
113
views
A bug in "AngularJS" section in Documentation [closed]
I have edited the Custom directives topic by changing the Parameters aria with new content and submitted it to review.
Next, I have responded to this improvement request, and updated the example with ...
2
votes
1
answer
82
views
Should Documentation links point to external or internal resources? [closed]
This came up while discussing an edit to one of the Haskell documentation pages. A user proposed an edit to change a link to Data.Text from Hackage, where the official, core documentation is about the ...
2
votes
1
answer
126
views
What to do when other committers don't care about your proposed changes? [closed]
I am one of the committer of Sqoop Documentation. I added a new example in Sqoop tag before 4 days.
It's status is Awaiting approval.
What should I do when other committers don't care about your ...
2
votes
1
answer
58
views
Selecting all versions beginning from a particular version [closed]
In documentation, suppose I am adding an example for a C++ topic that came into being C++11 onwards. Now how do I go about selecting the versions?
Option 1> Select C++11, C++14, and C++17
Cons: The ...
2
votes
1
answer
52
views
Documentation: requesting contributors' global dashboard or activity list akin to SO's front page [closed]
I hereby request a global dashboard, activity list, review queue, or something for Documentation that shows recent activity across all tags. That way, proposed changes will be more visible at the ...
2
votes
1
answer
44
views
Documentation icon is visible in preview, but not in the actual post [closed]
In Stack Overflow Meta, the documentation icon is visible in the preview, but the same is not visible in the actual post.
For example, in this question's preview mode the icon is visible, but in the ...
2
votes
1
answer
40
views
Cannot commit to proposal, answers on non-Stack Overflow site are not counted [closed]
I want to commit to the Puppet proposal here:
https://stackoverflow.com/documentation/puppet
But it tells me that I don't meet the criteria of:
"With at least 1 positively scored answer in [puppet]"
...
2
votes
1
answer
41
views
Version changes conflict with examples in documentation [closed]
Twice I tried to add rails 5.0 release to versions in https://stackoverflow.com/documentation/ruby-on-rails/225/introduction-to-ruby-on-rails#t=201607211215320131392 , and both times edit was rejected ...
2
votes
0
answers
105
views
Are we removing all links to the documentation? [duplicate]
One of my answers which has link to the documentation was changed by a high-rank user at SO, where the change was only to remove the link do the documentation.
It wasn't a new user (so it wasn't in ...
2
votes
0
answers
91
views
UI labels overlapping with each other [closed]
In the above picture you can see two options overlapping with each other in Firefox browser version 38.0.1 - Windows OS. I have some add-ons like Selenium IDE, REST client and Firebug.
2
votes
0
answers
57
views
3 problems with documentation request flag button layout [closed]
The "Flag" button seems a little bit misplaced (up and right):
While this css would fix the problem...
a.doc-flag-link.sub-action-link {
margin-top: 1px;
margin-right: 3px;
}
there is ...
2
votes
0
answers
107
views
Reference an example in Stack Overflow Documentation in another example [closed]
I am reading documentation to learn about a software tool and have been improving the examples if I see an issue with them. In many examples I think that it would be very convenient if users could ...
2
votes
0
answers
56
views
Can't save remarks: error states that title and code section are missing [closed]
I'm fairly new to Stack Overflow. I am having a hell of a time understanding how to use the site.
I attempted to post a new topic in the PHP section, I filled out the introduction and a code sample. ...
2
votes
0
answers
53
views
Documentation changes for minor differences [closed]
Recently I started reviewing and editing on the Stack Overflow Documentation and noticed that quite a few proposed changes do not consider the specified version of a topic.
As an example this change ...
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 ...
2
votes
0
answers
56
views
Documentation - Adding requests for deleting topics [closed]
As of now, users can request improvement to existing topics, and request creation of new ones.
I believe there should also be the option to remove topics that have been added due to review oversight ...
2
votes
2
answers
63
views
Cannot upvote comments on topic requests in documentation [closed]
I looked at the topic and tried upvoting the comment but found that there is no upvote button.
2
votes
0
answers
39
views
Revert "handles improvement request" but keep the rest? [closed]
The following change:
https://stackoverflow.com/documentation/review/changes/139205?filter-tags=c%2b%2b
is a good change in itself, but it does not handle the improvement request that it claims to ...
2
votes
0
answers
35
views
Topic Outline links not working on documentation page in Firefox or IE [duplicate]
Browse here: https://stackoverflow.com/documentation/c%23/26/keywords
Click on one of the Topic Outline links on the right hand side of the page (e.g. volatile).
Nothing happens.
Problem occurs for ...
2
votes
1
answer
47
views
Reject Documentation Topic Creation with barely any Content [closed]
When browsing the "Documentation: Proposed Changes" review queue I came across a topic creation that featured barely any content. 2 sentences for the introduction and 1 line of code in the example. ...
2
votes
0
answers
257
views
An alternative direction for Stack Overflow Documentation: as a Code Repository [closed]
I was reading yet another "Has Documentation Failed?" question, and came across this:
... most examples on Docs.SO are not "real-world code". They're artificial, used to explain a specific point.
...
2
votes
0
answers
31
views
Image and text in documentation quick tour differ [duplicate]
As you can see, the image shows a +10 while the text states +5 for the amount of reputation earned when an example is being upvoted.
2
votes
0
answers
118
views
The Community user should be proposing these changes for me [closed]
So here's my latest set of Documentation edits:
I kind of feel like I shouldn't be getting this much rep from these. (Admittedly not quite as much at the moment given how close I am to 3K, but…) If ...
2
votes
0
answers
42
views
How are readers linked to an Example supposed to navigate to the Remarks? [closed]
In What's Documentation for? the OP noted that
the Example [in Topic "Asyncio Module"] uses concepts like "asyncio" and "executors" without explanation even though this is my first time ...
2
votes
0
answers
41
views
Review queue “Documentation: Proposed Changes” appears to forget reviews (temporarily) [closed]
Observed behaviour
I recently reviewed this proposed change.
I decided to reject for plagiarism and saw afterwards that I seemed to be the only person to have reviewed this.
But when I looked into ...
2
votes
0
answers
59
views
Please add a way to star a documentation item [duplicate]
I am used to learning from documentation and sometimes I want to keep a record of it so it would be helpful if I could have a feature of marking documentation for an future reference.
Note: For those ...