All Questions
Tagged with documentation-examples documentation
43 questions
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 ...
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:
...
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 ...
29
votes
1
answer
212
views
Notification of my examples being deleted [closed]
Having spent some considerable time writing an example on Regular Expressions in Swift I was really surprised when I couldn't refer to it today.
It turns out it was deleted (even though it had a ...
29
votes
1
answer
560
views
How can I appeal against the deletion of an example in Documentation? [closed]
How can I appeal against the deletion of an example in Documentation? For questions on Stack Exchange, one can vote to reopen. Is there anything similar in Documentation?
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 ...
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 ...
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 ...
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 ...
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 ...
17
votes
1
answer
127
views
Viewing revisions of a moved example created prior to the move results in 404 page [closed]
Moving examples between topics is a great way to reduce clutter and confusion. However, trying to establish what happened on an example prior to the move produces errors...
Steps to reproduce
Find ...
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 ...
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/...
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 ...
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 ...
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 ...
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 ...
4
votes
0
answers
74
views
Create an easy way to "promote" code in an answer to a documentation example [closed]
Obviously there are great code examples to be found in the wild on SO.
Can a mechanism be provided to facilitate creating a Documentation example from them?
Either just a code block, or part or all of ...
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 ...
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 ...
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 ...
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
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 ...
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
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 ...
2
votes
1
answer
57
views
Shortened links to topics and examples in Documentation [closed]
So here's the link given to topics in Documentation:
https://stackoverflow.com/documentation/tag-name/topic-id/topic-name
And here for examples:
https://stackoverflow.com/documentation/tag-name/...
2
votes
1
answer
106
views
"Duplicate" or "copied" examples in Documentation [duplicate]
Some examples are in different topics, but they're exactly the same. For example, if there's a topic on scoping and a topic on functions, both would have a function scope example.
When adding a new ...
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 ...
2
votes
0
answers
60
views
Alignment issue in the Documentation examples [closed]
In the documentation example section (Click on + Add Example icon on any documentation page), there are two minor alignment issues.
The Markdown Editing Help icon has extra back ground color.
The ...
2
votes
0
answers
55
views
How to recover a discarded documentation draft after it had been submitted for review? [closed]
I spent quite a while documenting something and submitted it for review.
I then wanted to make a change and it didn't work like I wanted, so I said to discard it thinking it meant the subsequent ...
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 ...
2
votes
0
answers
57
views
How to post an example for documentation [closed]
I'm trying to post a new example on documentation when I wrote significant material to post and added some images Than I tried to submit that example. I pressed Submit for Review button but an error ...
2
votes
0
answers
44
views
Moving documentation example to another topic - Error [closed]
I've added a proposed change examples for time measurement in Debugging topic of Javascript language Documentation. link: Javascript.Debugging
Fellow user pointed out that a similar topic (with only ...
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 ...
1
vote
1
answer
106
views
I have a problem to add changes into Stack Overflow Documentation [closed]
When I'm trying to open some topic in Stack Overflow Documentation it shows me error
Oops! Something Bad Happened!
After some time, it works, but when I'm trying to add or edit some topic it just ...
1
vote
1
answer
42
views
Move an example within one draft [closed]
I just want to move an example above another example.
The whole draft is created by me and currently not public.
Isn't that possible?
0
votes
1
answer
152
views
Documentation Example modified by other user and now deleted [closed]
I invested my time and contributed an example in Operators in C# tag and it is approved my other users. I also provided Demo for this example - Available Here
But This User totally removed my ...
0
votes
0
answers
60
views
Documentation example code snippets [duplicate]
Why can we not add a code snippet to a documentation example?
I would like to add an example to the block and inline elements page that showed an examples of each and how they reacted with each other....
-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"
-1
votes
1
answer
141
views
My Example got approved, but never got the reputation for it? [closed]
My topic and example just got approved in Documentation. But I did not gain any reputation for the same. Why did this happen?
My example is this one:
https://stackoverflow.com/documentation/jboss/...
-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 @...