Linked Questions

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 ...
  • 1,796
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 ...
  • 69.5k
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 ...
  • 20.8k
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 ...
  • 17.4k
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 ...
  • 170k
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, ...
  • 383
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: ...
  • 1,406
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 ...
  • 5,819

15 30 50 per page
1
2