Skip to main content

All Questions

Filter by
Sorted by
Tagged with
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 ...
Alon Eitan's user avatar
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 ...
ZygD's user avatar
  • 24.2k
-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"
Fattie's user avatar
  • 12.5k
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 ...
Wilt's user avatar
  • 44.2k
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 ...
Visual Vincent's user avatar
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 ...
jkris's user avatar
  • 6,441
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 ...
Kirk Woll's user avatar
  • 77.5k
-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 @...
ppeterka's user avatar
  • 20.7k
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 ...
Jens Schauder's user avatar
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 ...
Travis J's user avatar
  • 82.2k
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 ...
Athari's user avatar
  • 34.2k
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 ...
Agaz Wani's user avatar
  • 5,674
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 ...
clickbait's user avatar
  • 2,988
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 ...
Wasabi Fan's user avatar
  • 1,853
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 ...
skrrgwasme's user avatar
  • 9,633
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: ...
elegent's user avatar
  • 3,977
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 ...
ppeterka's user avatar
  • 20.7k
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 ...
mfaani's user avatar
  • 36.1k
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/...
Robin's user avatar
  • 8,466