All Questions
Tagged with documentation documentation-examples
15 questions
58
votes
3
answers
654
views
Do we need to adapt our voting system for documentation examples? [closed]
The documentation voting system reminds me somehow of "Hot Network Questions" and their answers:
You vote it up because others voted it.
The result can be seen for example in Javas Arrays topic:
...
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 ...
4
votes
1
answer
151
views
Calculation of major/minor contributions is broken [closed]
The example had 2 major contributors (one having contributed 308 and -20 chars, another 567 chars).
I edited the example and was transformed into a major contributor.
Wrong things happenned:
A user ...
3
votes
3
answers
244
views
Maximum number of examples (6) exceeded? [closed]
I was just trying to contribute something to Documentation, but I got an error saying:
Maximum number of examples (6) exceeded. Consider deleting examples, moving examples to another topic, or ...
2
votes
1
answer
134
views
Additional points for citing an example? [closed]
When I got my Bluebook badge I got 5 extra points because I cited an example. However the following time I cited an example (not one I'd contributed to) I got a Creditor badge but no additional rep ...
-6
votes
1
answer
303
views
The Dreaded Java Arrays "topic" - rate my draft [closed]
I took my chances on this mutated huge topic, and put in some time to see what I can do. This topic is one of the worstest, even making it to the Reducing the number of examples... question by @...
59
votes
0
answers
380
views
Provide an indicator that your draft is out of date due to edits made after you started it [closed]
I started editing a popular documentation example, but I didn't have enough time to complete the edit in one sitting, so I saved it as a draft. The next day, I finished editing the example and ...
21
votes
4
answers
839
views
Are examples allowed to be too large? [closed]
There is some debate on what the size of an example should be. Some of the discourse has been focused on the balance between prose and code, and some between snippet or tutorial.
However, I would ...
13
votes
1
answer
299
views
Are multi-step examples wanted, in the documentation? [closed]
I've been adding some examples to the Ruby on Rails documentation tag and came across a few topics, which have multiple example, which are connected to each other.
E. g.: https://stackoverflow.com/...
13
votes
1
answer
292
views
Why does my improvement request bar me from handling anyone else's? [closed]
Why can't I handle an improvement request on an example if I made one myself—for something that I can't handle obviously?
e.g.
first request asks for A
my request asks for B (I made the request so ...
5
votes
1
answer
76
views
Documentation contributor chain on an Example is broken after a Topic move [closed]
Strange journey to get here
I gave this answer, where I linked to a docs example I wrote back before public beta
I got the Creditor badge for said link. But...
First citation of a topic or example ...
5
votes
0
answers
86
views
The CSS Selectors' 'Universal Selector' and 'Type Selector' examples have been deleted, can this be undone? [closed]
Yesterday a user deleted the Universal Selector and Type Selector examples, claiming that these were "duplicate content". This change was approved by a user with just 152 reputation. However I can't ...
3
votes
0
answers
50
views
Discarded attempt to move an example now results in an error [closed]
Probably related to Documentation: moved an example - the topic is now bugged/unavailable.
I edited in a synopsis to Running repair on Cassandra, and then I realised there's already a similar topic ...
2
votes
1
answer
73
views
Documentation Example - Improve instead of delete? [closed]
I'm still attempting to get my head around the documentation examples and what should be a topic or an example. To further add to my confusion one of the examples I contributed to has been deleted, ...
2
votes
0
answers
89
views
Can we have granular approval/rejection? [duplicate]
It's probably not that simple to implement but it would greatly help us out emptying the current backlog of changes.
user story
user A submits 2 examples X and Y on the same topic
user B knows ...