Linked Questions
30 questions linked to/from More hierarchical structure needed for documentation topics
57
votes
3
answers
709
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 ...
31
votes
3
answers
770
views
A better Documentation model: Task, not Topic [closed]
The current documentation model is focused on a set of arbitrarily defined topics, within which are examples.
I believe that this model has led to widespread confusion about what Docs.SO is for, and ...
122
votes
2
answers
3k
views
Why did Stack Overflow docs choose such a simple structure of organizing documentation? [closed]
I'm not sure about the motivation behind creating the SODocs project. But I'm personally very disappointed by it. If you are looking for the solution to a very specific problem, Stack Overflow is ...
32
votes
1
answer
389
views
Documentation: Support for lack of 1:1 correspondence of SO tags to Docs.SO tags [closed]
Many times, we create tags in SO for different versions of a language/library/etc. This is fine for SO, since we use tags for categorization and finding the right audience for a question.
But in Docs....
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 ...
16
votes
1
answer
230
views
Languages and the environments where they're used should have different tags [closed]
Right now the JavaScript section of Documentation is having a lot of topics and examples regarding one of its environments, the browser.
Node, which is another JS environment has its own section.
...
8
votes
2
answers
130
views
Let me vote on remarks and sort them in with the examples [closed]
Documentation prioritizes examples1. The official Jsoup cookbook already has the examples/recipes a user needs to use Jsoup effectively; there's no point in replicating them in Documentation.
...
12
votes
1
answer
181
views
Can we use citations to evaluate the usefulness of Examples? [closed]
Back when Documentation was announced, we got this comment:
If SO became the #1 repository of easily-searchable examples by language, framework, etc. I would never look anywhere else. Yes, one can ...
7
votes
0
answers
265
views
'popular' in documentation
In documentation when 'popular' tab is selected, the tags are ordered based on the number of topics each tag has got (screenshot below).
In the main page of each tag, it looks 'popular' tab orders ...
9
votes
0
answers
163
views
Documentation wikis to prevent duplicated content between tags [closed]
Can we have a 'Documentation Tag Wiki' that sits within the dashboard page of a tag and gives a brief explanation of what should be documented under that tag?
I've just made a change to the remarks ...
0
votes
1
answer
99
views
Qualify participants by standards/examples test not rep [closed]
The Q&A review process tests reviewers occasionally and implements temporary review bans when applicable.
Why is there nothing similar in Documentation? Anyone can enter or review whatever they ...
4
votes
0
answers
64
views
Documentation: Has there been any discussion around related/linked documentation topics? [closed]
Has there been any discussion of how to re-use or group together documentation that is relevant to multiple technologies? Linux seems like a big problem in general. Ubuntu, Mandrake, Puppy, Red Hat, ...
2
votes
0
answers
59
views
What is wrong with the vertical spacing in bulleted lists?
There is a related question: rendering of lists. It is marked as "status-completed" however but I am not sure if it is the same problem.
Now I am on Windows+Firefox and I see such a picture:
...
3
votes
0
answers
43
views
Add stackoverflow-style tags to topics [duplicate]
There's been a post requesting a hierarcheral to documentation, but I think it's not very user friendly. Instead, I propose Stack Overflow tags. They take longer to access and are more complex
Take a ...
3
votes
0
answers
41
views
Order of examples within a topic [duplicate]
Examples are currently shown in the order they were created. What happens when later examples are providing more basic information about the topic than earlier examples? Should a mechanism for ...