Linked Questions

186 votes
9 answers
3k views

Can we please introduce more reputation limits for examples on Documentation? [closed]

Documentation. Also known as a gold mine for people who love to get easy reputation points. Right now it's being (ab)used by many users, some of whom are using it to exponentially increase their ...
57 votes
25 answers
3k views

Naming the Documentation Feature [closed]

In "Warlords of Documentation: Your Quest(ions Answered)", Kevin Montrose mentioned: Is Documentation the right name? This is a tricky one, as there seems to be a fair amount of variance in ...
  • 173k
93 votes
2 answers
2k views

What, exactly, is Documentation? [closed]

I read the tour page on Documentation and it looks to me like it is meant to document errors and such things. That seems broad to me. Could anyone explain exactly what it is and how it's going to be ...
user avatar
31 votes
4 answers
878 views

Documentation - Short Example VS Long Example [closed]

Should we keep example in the documentation relatively short or the bigger the better? The example that raised this questioning is the following one : https://stackoverflow.com/documentation/java/99/...
  • 4,603
47 votes
2 answers
763 views

Documentation by example: Example of good documentation [closed]

The apparent foundation of Docs.SO is the belief that examples are more important than text. That seeing an example communicates better than words. There appears to be a general misunderstanding ...
32 votes
2 answers
646 views

Reduce importance of examples in Documentation [closed]

From what I understood from the numerous discussions about Documentation and from the tour, Documentation is based on the following hypothesis: documentation based on examples is more useful than a ...
  • 18.5k
8 votes
1 answer
403 views

Are answers to too-broad questions a good fit for Docs? [closed]

As we are preferred to give examples in documentation, would the answers in these questions be suitable? This question had been closed (as too broad - which is actually quite true), re-opened (on ...
30 votes
1 answer
279 views

"What kind of topics should I document?" [closed]

Every site of the StackExchange network has the two following entries in their help-center*: What topics can I ask about here? What types of questions should I avoid asking? I think something ...
  • 103k
6 votes
2 answers
165 views

Should C topics be kept to a single function? [closed]

The C documentation has good quality topics but most are centred around just that, topics (e.g. string manipulation). Looking at the sections a topic has - remarks, syntax, parameters, etc - it seems ...
  • 9,476
8 votes
1 answer
115 views

What is the scope of a topic? [closed]

I recently reviewed a proposal for a new topic. In this case, the user wanted to make a topic dedicated to the singleton pattern under the JavaScript section. I suggested that the user create a ...
  • 31.5k