All Questions
19 questions
2
votes
1
answer
120
views
How to handle duplicate example exist on other website (Which is not plagiarized) [closed]
I recently deleted an example from the documentation - It was in a form of an article, WITHOUT any attribution, well written, almost too good to be an original documentation example that was never ...
50
votes
1
answer
742
views
Documentation examples are not examples [closed]
It bugs me already a long time. There's inconsistency in what is called "examples". In the documentation section I was originally willing to find many examples for some topic, because this is how ...
-1
votes
1
answer
79
views
Documentation - how to suggest "eliminate an item"? [closed]
I don't know where the "suggest delete" button is on Documentation "examples"
6
votes
1
answer
257
views
How to improve documentation (and copy pasting official docs) [closed]
My curiosity made me visit the link to the documentation pages for Doctrine 2 which was shown in the side bar when going through posts tagged with Doctrine2.
In the first installation and setup ...
2
votes
0
answers
92
views
Is it acceptable to use documentation examples for pointing out/proving/confirming certain things? [closed]
I've been thinking of writing a documentation example which's purpose is to prove/confirm a certain statement, but I'm unsure if this is considered "acceptable" (even after reading the FAQ) or is what ...
3
votes
0
answers
56
views
Better improvement requests options for Documentation [closed]
The current options for Improvement requests are only the following:
All of them come out as somewhat negative. I simply wanted to let the author know of some improvements that I felt that could ...
18
votes
0
answers
359
views
Too many examples? [closed]
I was browsing the C# topic on generics and noticed that there wasn't a good canonical example for how to marry behavior that knows the type arguments with scenarios in which you do not know the type ...
-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 @...
24
votes
0
answers
259
views
Is this a good example for documentation? [closed]
There have been significant contributions from multiple people to this "example" in the Java tag.
But I think it is not a good example at all:
Picking an IDE is only tangentially related to the Java ...
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 ...
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 ...
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 ...
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 ...
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 ...
18
votes
2
answers
214
views
Should counter examples be included in Documentation? [closed]
I recently created this draft for the Python Polymorphism topic:
https://stackoverflow.com/documentation/python/drafts/61990
In it, I provided a basic example of polymorphism, and a counter example ...
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:
...
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 ...
3
votes
1
answer
100
views
Should documentation examples' highest vote be the most generic example? If it's voted too much what should I do? [closed]
To me documentations are different from SO questions they should first address the most applicable scenario and then from there answer questions that are less common. If they answer corner cases then ...
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/...