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,376
questions
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 ...
2
votes
0
answers
34
views
Empty change causes an error when approving/rejecting [closed]
Take a look at these changes:
https://stackoverflow.com/documentation/proposed/changes/21647
https://stackoverflow.com/documentation/proposed/changes/12918
The diff is empty. When I try to approve ...
2
votes
0
answers
21
views
Notification doesn't reflect the updated example title [closed]
I've just received a notification for a +1 vote to an example I contributed. One of the contributions I made (that was approved) was to rename the example.
However, the notification was showing the ...
2
votes
0
answers
26
views
Comments disabled on proposed change that deletes a topic [closed]
Before I approved this change, I was unable to comment on the proposal. This doesn't seem to be the intended behavior. I do know that:
This proposal handles an improvement request submitted by me.
...
2
votes
0
answers
19
views
Versions section in arbitrary subject really horrible UX [closed]
I was complexly confused by where the versions I kept seeing everywhere were defined, as there was no obvious top level "Control Page" where those would emanate from.
If versions are a central ...
2
votes
0
answers
22
views
Change sort order and add paging for search results [duplicate]
When I perform a search like https://stackoverflow.com/documentation/search?tag=c%23&query=exception to get documentation about Exceptions in C# the results are ordered by something I cannot ...
2
votes
0
answers
49
views
Future Versions in Documentation's Inline Versions [closed]
I've already found myself rubbing up against the
<!-- if version
Structure being overly strict.
I have a feature that I can document as being in a sort of "Pending" state in a future release ...
2
votes
0
answers
18
views
For things requiring multiple approvals/rejections, show current approvals/rejections [closed]
I think my biggest frustration today whilst reviewing things is not being able to see what others reviews have contributed.
For example, currently two rejections are needed to actually reject ...
2
votes
0
answers
53
views
Can't move examples to an existing topic if there's a pending move waiting for the same topic (or so I think?) [closed]
I am trying to solve this, but meanwhile I decided to move all examples to a single topic. That seems to be easy pie, just click move and voila! Well, the first one went without a hitch, the second ...
2
votes
0
answers
25
views
Put topic name first and username second in Activity tab [closed]
https://stackoverflow.com/documentation/c%23?tab=activity for example. Currently the editor's name goes first and then the edited topic. I don't think people look for editor names first, rather the ...
2
votes
0
answers
46
views
Two Column Restriction for Parameters Section Chokes on Rich Formatting [closed]
It seems that the strict two-column restriction chokes on rich formatting in general, even when all of the formatting and content is contained in a two-column layout. See this draft:
2
votes
0
answers
28
views
Navigating Between Documentation Tags is Difficult [closed]
Documentation has just came out, and I'm already finding myself using it — not just to contribute, but actually consuming it as well. Unfortunately, I'm finding it difficult to navigate between ...
2
votes
0
answers
37
views
New example duplicates in documents when clicked the plus mark [closed]
When I click the plus button with 'Add Example' in the documentation section it opened two instances of examples. Though it wasn't noticeable at the creation but when you going to submit a draft an ...
2
votes
0
answers
32
views
Hiding examples expanded to the side [closed]
When choosing to expand examples to the side:
Then clicking the example title to hide it (on the left):
Usually it'll leave a plain x on the side:
Even worse, if you hide the example in split-view ...
2
votes
0
answers
37
views
Is this "Collections and Sequences" Documentation topic too broad? [closed]
Earlier today, a request was made for a "Collections and Sequences" topic in the Clojure Documentation:
Built in Clojure collection data structures and an explanation of the Sequence ...
2
votes
0
answers
50
views
Removing upvote (unupvote) on documentation example reduces rep of contributors, but doesn't reset rep cap [closed]
If I upvote an example and remove the upvote 20 times, the guys that earn rep will earn 0 in total, but their rep cap will be reached. I ran into this problem now, got 10 upvotes and 5 removed their ...
2
votes
0
answers
24
views
Best place to put style/conventions in Documentation [duplicate]
Haven't seen much on style/conventions in Documentation. Should that just be inferred from the Syntax category? Or should that be its own topic within a tag? Any other ideas?
2
votes
0
answers
35
views
For Documentation Beta, how do we output results in example? [duplicate]
When creating examples for HTML, CSS, and Javascript topics, I couldn't find an option to use code snippets. Code snippets makes it much more easier to understand, and it's convenient. Plus, people ...
2
votes
0
answers
26
views
What should I do when I see an off-topic example in documentation? [closed]
I started using documentation and in the very first topic I viewed there are already off-topic example as to "debugging in javascript" instead of printing stuff to "say hello".
I'm sure we will see ...
2
votes
0
answers
28
views
Requesting a review of a rejection of a new Topic with examples [closed]
In this example, the rejection included the comment that the user is of the opinion that the individual examples are well written but belong in a different existing Topic. Meanwhile, I am of a very ...
2
votes
0
answers
39
views
Is a single rejection final? [closed]
My proposed improvement was rejected by a single user. Can any single user veto any proposed change?
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
26
views
Request Topic search should include Topics pending approval [closed]
When you click on Request Topic and do a search, it should also search in the topics that haven't been approved yet.
I just created a topic on padding in CSS, only to find out after that there is ...
2
votes
0
answers
55
views
Issues with Reputation on Documentation [duplicate]
One concern with the current reputation distribution system is the fairness of distributing reputation to all users with "substantive" edits (how is "substantive" itself even defined??). This makes it ...
2
votes
0
answers
35
views
Issues with Citations on Documentation [closed]
What is the best practice for adding citations? For example, I proposed a topic in Excel VBA that I know already has a very comprehensive answer on SO written by Siddharth Rout (it is linked to all ...
2
votes
0
answers
69
views
Documentation content overlapping with sidebar [closed]
There is an alignment issue in the SQL Example Databases topic. The content is overlapped with the side bar.
Screenshot for reference:
2
votes
0
answers
113
views
Expand/Collapse is set to Expand on page load when section is already expanded [closed]
On documentation topic pages, the expand/collapse button on the Examples section is set as Expand when a page is loaded, when the examples are already expanded:
Resulting in a user having to click ...
2
votes
2
answers
85
views
How to change the tag of a draft? [closed]
I've spent a fair amount of time writing a document on Stack Overflow's documentation beta. It has been rejected by two reviewers for being in the wrong tag. I've put it in the XAML tag, and they're ...
1
vote
1
answer
216
views
Can I copy & paste documentation from Google or other sources? [closed]
Would it be wrong if a user copy-pastes the example from https://developer.google.com ? But of course, I explain more using comments and add text. Will it be wrong?
1
vote
1
answer
115
views
Where did the chat room for Documentation go? [closed]
I remember that there's a chat room to discuss the public beta of Documentation.
The link's https://chat.stackoverflow.com/rooms/117558/documentation-public-beta. However, when I navigate to this link ...
1
vote
1
answer
51
views
Is it acceptable to paste documentation from a framework in to SO Documentation for that topic [duplicate]
An example is the MS BotFramework.
The documentation on their site is pretty extensive. Is it acceptable to paste that information directly into a SO Documentation topic? Or does it all have to be ...
1
vote
2
answers
157
views
Add indicator saying if user has contributed to Documentation [closed]
We have Docs now, and some signs indicate that it completely changed the way reputation is perceived.
Some users may love this, but others don't as you can see here and here.
If the rep is not going ...
1
vote
1
answer
75
views
Helping good Documentation rise to the top [closed]
There's a LOT of examples going up on Documentation ... some good and some bad.
It seems to me that we might need an additional way of letting good examples rise to the top and bad answers fall to ...
1
vote
1
answer
60
views
Add a link to each tag’s Documentation in users’ profiles [closed]
Currently, users’ profiles have a Top Tags section:
I’m proposing that a “Documentation” link be added to each tag:
This increases discoverability of the Documentation feature, as well as showcasing ...
1
vote
1
answer
88
views
No reputation gain for approved edits in "R Language" [closed]
Even though my contributions are approved, no reputation is awarded for R Language Documentation. I receive +2 reputation for other topics such as Latex, but not for R Language.
1
vote
1
answer
117
views
Vote button missing [closed]
I have just added a new example on Documentation and the voting buttons are not visible.
Maybe it happens just for very long titles. It seems related to this issue about overflowing into the buttons ...
1
vote
1
answer
44
views
Should we edit past answers to add cittation to the documentation? [closed]
As this new Documentation thing is on board, should we edit our past answers, including citations to the Documentation ?
1
vote
1
answer
78
views
Stack Overflow Documentation tab: is there a way to point a question and/or answer to a documentation topic? [closed]
Regarding the documentation (beta) tab, is there a way to 'migrate' a question and/or answer to a certain documentation topic?
1
vote
1
answer
51
views
Errors expected in documentation [closed]
In documentation, it is not acceptable to have wrong information, and when a user suggests an example or an edit to a specific post, there is no guarantee that his suggestions are true even ...
1
vote
1
answer
89
views
Adding code block into introduction [closed]
Trying to add the introduction below fails with this error message (and only when Submit for Review is hit):
Introduction must be simple markdown - no images, tables, lists, etc.
Without the ...
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 ...
1
vote
1
answer
43
views
Documentation: duplicate topics shown but it's the same record [closed]
So I encountered this when browsing the documentation topics for VB.NET:
Here's the link
Additional detail (dunno if it would help): I was the other editor in the second topic.
The first topic ...
1
vote
1
answer
75
views
Documentation Review filter based on tag option [closed]
It will be good if documentation review might have a filter by tag option, because IMO there is dilemma of whether contribution is good or bad of other tags, because some of them have good editing ...
1
vote
1
answer
47
views
Bugs/Error, any specific way/format to submit these [closed]
Recently I have been getting many errors particularly in documentation, though I asked question here on the one of the error, but I don't think there's any appropriate answer for the same, since it's ...
1
vote
1
answer
41
views
Documentation suggest a number of changes [closed]
I am new to documentation, I was trying to improve upon some existing answers but there was a dilemma. Say I have 5 suggestions to be made on the same question, once submitted either they all are ...
1
vote
1
answer
114
views
A minor edit to Documentation to add colouring to code, is it correct? [closed]
I've came across a user who is adding very minor changes to the documentation, that I believe, don't make it any more readable.
They've gone through and added the tag before any code without it. An ...
1
vote
1
answer
42
views
Documentation Beta - basic UX points [closed]
I've requested that a new topic is created for a particular tag and submitted an example to go with it.
How does my new topic request get "approved"?
It seems that I can "create" the new topic myself,...
1
vote
1
answer
58
views
Migrating examples to another topic [duplicate]
In gulp tag, there's a topic for Gulp Tasks. Every other example of a task has been put there. I think the better way would be to create separate topic for separate task performed by Gulp. I had ...
1
vote
1
answer
37
views
How to remove example? [closed]
I can see that users remove low quality/downvoted examples of other users, but I can't fugure out, how do they do it?
If I try to edit such an example and remove everything UI says I need to write a ...
1
vote
1
answer
46
views
New topic and example doesn't show up, message incorrect [closed]
I created a new topic under VB.NET, and then added an example, seen in the following image.
I can't find a link to my proposed topic or change anywhere in the VB.NET documentation page. I have to go ...