Questions tagged [documentation-topics]
For discussion and questions relating to Topics (mid-level categories) in the Documentation public Beta.
112 questions
8
votes
0
answers
97
views
Duplicate topics in Python documentation [closed]
In Python documentation, we have two topics on list comprehension:
List comprehensions (8 examples)
List Comprehensions (5 examples)
Both have received hundreds of upvotes. How should we handle this?...
2
votes
1
answer
68
views
Why can't I edit topic title in documentation [closed]
Why can't I edit topic title in documentation?
I see that there's a request that Topic title should change but I can't edit it
2
votes
1
answer
47
views
Is this overlay on click of Request Topic button expected? [closed]
I'm not sure if it is cosmetic UI defect or is it intentional, but to me, it surely doesn't look too promising. When I click on Request Topic button on MySql Documentation page, there is full page ...
1
vote
0
answers
36
views
How can I move or request the move of a documentation example to a different topic? [duplicate]
How can I move (or request the move) of a documentation example to a more appropriate topic?
Related questions appear to rely on early-beta functionality that is no longer present.
58
votes
3
answers
2k
views
Users are creating Topics in Docs without any guidance or cautions [closed]
I've been trying to keep the PHP list of Topics clean. A common issue I'm seeing (and removing) are Topics that are just too localized (i.e. tutorials on how to perform some highly specific task), but ...
23
votes
0
answers
269
views
Categorize topics [closed]
I've started to look into using the documentation section to try to learn about new technologies. I started with C# and found there were 100+ topics to look through. There was one "Getting Started" ...
18
votes
1
answer
187
views
Typo in the title attribute of introduction topic [closed]
There is a typo in the title attribute of "Introduction Topic" in the h1 of Getting Started documentation topics (example topic).
Ths topic is an introduction to should be This topic is an ...
3
votes
1
answer
67
views
navigation to example in topic outline of documentation [closed]
The topic outline of a tag in documentation is a great way to navigate in big topics like HTML - input control elements.
But I miss the navigation to that example. When I click on a title in the ...
1
vote
1
answer
52
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 ...
5
votes
0
answers
61
views
Partial text visible in the topic request section [closed]
There is some partial text visible issue in the documentation beta - topic request section.
Link for this issue: https://stackoverflow.com/documentation/sql-server/topics?tab=requests
Screenshot for ...
7
votes
0
answers
135
views
Alignment issue with Documentation - topic and discussion tabs are stacked [closed]
There is an alignment issue in the Documentation Beta. The topic and discussion tabs are misaligned in the Firefox browser.
Firebox: 50.1.0
OS: Windows: 8.1
Link for the reference: https://...
1
vote
0
answers
35
views
Unable to edit remarks on a Documentation topic [duplicate]
I am trying to add a documentation topic to the Ruby on Rails tag. However, in the bottom pane, the site lets me edit the Examples section but not the Introduction section or the Remarks section. Can ...
2
votes
1
answer
52
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
74
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 ...
7
votes
1
answer
222
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, ...
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.
...
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/...
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?
28
votes
1
answer
893
views
Still have a question about [topic]: it doesn't always work [closed]
I know some questions have been asked about this before, but I believe this one is different.
The sentence "Still have a question about [topic]" just doesn't always work with the name of the topic.
...
3
votes
1
answer
39
views
How to deal with intersecting documentation topics? [closed]
The question is arising in the Rust tag at the moment, but I can imagine that others will encounter the issue.
We have a popular serialization framework (Serde) with its own topic
We have requests ...
0
votes
1
answer
152
views
Documentation Example modified by other user and now deleted [closed]
I invested my time and contributed an example in Operators in C# tag and it is approved my other users. I also provided Demo for this example - Available Here
But This User totally removed my ...
2
votes
2
answers
207
views
How do we document a service with multiple language-specific SDK's? [closed]
The example I'm thinking of here is the amazon-web-services tag.
Now AWS has SDKs for Android, CLI, JavaScript, iOS, Java, .NET, Node.js, PHP, Python, Ruby, Go, and C++.
Now major kudos to Amazon in ...
2
votes
2
answers
101
views
Unable to delete almost empty topic [closed]
I am trying to remove the Introduction to saml-2.0 page, as it barely contains any information, is flagged multiple times with improvement requests and I've started a new, clean, topic with more ...
-13
votes
1
answer
117
views
Add badges for handling topic requests [closed]
There's one thing that stands out about Documentation: there's just so many topic requests that haven't been handled! ios has nearly 100, android has over 150, java has 26, etc.
What can we do about ...
1
vote
0
answers
21
views
Is it possible to order documentation topics? [duplicate]
I think it would be beneficial for the clarity of documentation if topics were ordered by difficulty and/or their importance in the course of learning about a subject. Is it possible?
-1
votes
1
answer
141
views
My Example got approved, but never got the reputation for it? [closed]
My topic and example just got approved in Documentation. But I did not gain any reputation for the same. Why did this happen?
My example is this one:
https://stackoverflow.com/documentation/jboss/...
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
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 ...
26
votes
2
answers
474
views
Life span of my documentation code examples and topics [closed]
I am answering some of SE questions by linking my own code examples from Documentation topics.
e.g. Difference between Strategy pattern and Command pattern
In future, is there any possibility of ...
-4
votes
1
answer
106
views
Pending approval requests for design-patterns topic documentation [closed]
The documentation requests for design-patterns topic has been in approval stage for more than a week.
From the badge stats, bronze badge has been awarded only 69 times till now => you can find less ...
2
votes
1
answer
55
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 ...
7
votes
0
answers
98
views
Documentation: splitting the command line section [closed]
I am asking this here, as suggested in the chat
command-line (and the associated tag) is a bit vague and can be misleading.
Should it be Unix or windows-oriented? I think there should be two separate ...
2
votes
1
answer
79
views
Someone requested a topic and I created it. Now what? [closed]
To get started with helping out with the documentation, I headed towards the google-chrome-extensions page and saw that a heavily requested topic was "Developer Tools Integration", so i clicked the ...
56
votes
3
answers
710
views
The forms and quality of Documentation Topics [closed]
Much has been said about what "topic" means on Docs.SO. The Powers That Be seem to feel that it is best for users to decide what "topic" means. Now that we're 3 weeks in, I thought it would be good to ...
27
votes
1
answer
538
views
Reducing the number of examples in huge topics to currently recommended 6 (12) examples per topic [closed]
Recently a limit to the number of examples per topic was introduced: 6 examples per topic for all users, 12 examples per topic for users with full editing privileges (2000 rep). I suppose that means ...
67
votes
4
answers
590
views
Don't auto-expand the first three examples when navigating to a topic [closed]
When I enter a topic for the first time, without having followed a link to a specific example, I end up on a page with the first three examples already expanded. For instance, opening Promises on ...
1
vote
0
answers
49
views
Documentation Topics does not have introduction section [duplicate]
A Topic have current sections as of now
Topic Name
Examples
Syntax
Remarks
In my opinion, one thing is missing : Introduction about topic.
Currently you can enter one line for Topic Name. ...
5
votes
0
answers
48
views
Documentation topic that has been deleted should have a reason [closed]
Recently, an entire topic was deleted in the Ruby Documentation. When I looked at it, I couldn't find any reason about why it was deleted. So, if I disagree with the removal, what stops me to rollback ...
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 ...
9
votes
0
answers
69
views
Can we have a link to documentation topic/example from the tag wiki? [closed]
I am thinking it would be easier to navigate if there is a link to documentation topic or example directly (if relevant) from the tag wiki page.
For example, https://stackoverflow.com/tags/python/...
10
votes
0
answers
222
views
Why can you vote for your own topic request? [closed]
We all know that you can't vote for your own posts, and there's a good reason for that.
As you can see in the image above, I created 2 topic proposals, and both of them were upvoted by myself. ...
5
votes
1
answer
192
views
Are obsolete documentation topics allowed? [closed]
I came across this topic on Stack Overflow Documentation:
https://stackoverflow.com/documentation/javascript/5212/deprecated-and-obsolete-features
It got deleted later on. Part of the deletion ...
5
votes
1
answer
201
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 ...
23
votes
2
answers
422
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 ...
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 ...
3
votes
0
answers
39
views
Expand the topic request interface [closed]
Topic requests need more information
Browsing through the topic requests doesn't give much guidance towards what people actually wanted a topic for.
I was looking in C# out of curiosity to see if ...
18
votes
2
answers
625
views
Documentation: Codeless topic - still having real value. Should it stay, or should it go? [closed]
While going through the proposed edits, this topic change proposal in Installing Java (Standard Edition) sparked controversy in me:
it does not have code - does not seem fit on 'Doc
it is is high ...
74
votes
4
answers
1k
views
Can I document my own library on Stack Overflow Documentation? [closed]
Can a developer of an open-source library available to the general public choose to put their own documentation on Stack Overflow Documentation, provided it is formatted appropriately and not copied ...
29
votes
1
answer
512
views
Are 'Tips & Tricks' style topics appropriate for Documentation? [closed]
There are some "classic" questions on Stack Overflow which were tremendously popular in their day, but which are now closed because they are not a single question with a canonical answer. As an ...
7
votes
0
answers
79
views
Display for Topic Request Dismiss vote? [closed]
I just dismissed a topic (this one) because it already exists. Everything fine so far, but after linking the existing topic and clicking ok, nothing happened - at least not visible. I wasn't sure if ...