Skip to main content

Questions tagged [documentation-topics]

For discussion and questions relating to Topics (mid-level categories) in the Documentation public Beta.

Filter by
Sorted by
Tagged with
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?...
nalzok's user avatar
  • 16k
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
Ori Marko's user avatar
  • 58.7k
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 ...
Sachin's user avatar
  • 41k
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.
Andy Thomas's user avatar
  • 86.3k
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 ...
Machavity's user avatar
  • 31.6k
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" ...
Cameron Rodriguez's user avatar
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 ...
Jan Zerebecki's user avatar
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 ...
H. Pauwelyn's user avatar
  • 14.3k
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 ...
David Pilkington's user avatar
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 ...
Arulkumar's user avatar
  • 13.2k
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://...
Arulkumar's user avatar
  • 13.2k
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 ...
Shivasubramanian A's user avatar
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 ...
miken32's user avatar
  • 42.7k
-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 ...
Nathaniel Ford's user avatar
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, ...
Brett Hale's user avatar
  • 22.3k
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. ...
Caleb Kleveter's user avatar
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/...
Nissa's user avatar
  • 4,684
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?
user6035379's user avatar
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. ...
user avatar
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 ...
Matthieu M.'s user avatar
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 ...
mmushtaq's user avatar
  • 3,520
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 ...
JamesENL's user avatar
  • 6,530
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 ...
Rick's user avatar
  • 411
-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 ...
Nissa's user avatar
  • 4,684
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?
helcim's user avatar
  • 809
-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/...
Pritam Banerjee's user avatar
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 ...
ppeterka's user avatar
  • 20.7k
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 ...
JamesENL's user avatar
  • 6,530
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 ...
Ravindra babu's user avatar
-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 ...
Ravindra babu's user avatar
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 ...
Ravindra babu's user avatar
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 ...
MayeulC's user avatar
  • 1,847
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 ...
Marc's user avatar
  • 3,622
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 ...
Nicol Bolas's user avatar
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 ...
Athari's user avatar
  • 34.2k
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 ...
Heretic Monkey's user avatar
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. ...
Ravindra babu's user avatar
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 ...
Redithion's user avatar
  • 1,006
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 ...
clickbait's user avatar
  • 2,988
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/...
mtk's user avatar
  • 13.6k
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. ...
clickbait's user avatar
  • 2,988
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 ...
clickbait's user avatar
  • 2,988
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 ...
Jonathan Lam's user avatar
  • 17.3k
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 ...
Wasabi Fan's user avatar
  • 1,853
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 ...
Wasabi Fan's user avatar
  • 1,853
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 ...
Travis J's user avatar
  • 82.2k
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 ...
ppeterka's user avatar
  • 20.7k
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 ...
Two-Bit Alchemist's user avatar
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 ...
Two-Bit Alchemist's user avatar
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 ...
Florian Koch's user avatar
  • 1,492