Skip to main content

Questions tagged [documentation-examples]

For questions regarding the examples that are used in Documentation.

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
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 ...
Volodymyr's user avatar
  • 6,549
2 votes
0 answers
33 views

Documentation example reputation is not displaying in the summary tab [closed]

The Documentation Example reputation is showing in the reputation tab and not in the Reputation section under the summary tab Screenshots for reference: reputation tab: summary tab:
Arulkumar's user avatar
  • 13.2k
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
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 ...
Arulkumar's user avatar
  • 13.2k
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
1 vote
1 answer
83 views

Option to merge two examples (or delete one) in documentation [closed]

Why isn't there an option to merge two examples or delete one altogether? Currently we have: Why not give an option to mark duplicate or cast delete vote? Example: Initialize serial device example ...
Ani Menon's user avatar
  • 28.1k
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/...
Nissa's user avatar
  • 4,684
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 ...
xaxxon's user avatar
  • 19.7k
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 ...
muru's user avatar
  • 4,877
3 votes
1 answer
39 views

How to deal with intersecting documentation topics? [closed]

The question is arising in the Rust tag at the moment, but I can imagine that others will encounter the issue. We have a popular serialization framework (Serde) with its own topic We have requests ...
Matthieu M.'s user avatar
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 ...
mmushtaq's user avatar
  • 3,520
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 ...
Machavity's user avatar
  • 31.6k
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 ...
Athari's user avatar
  • 34.2k
-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/...
Pritam Banerjee's user avatar
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
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?
Nicolai Weitkemper's user avatar
-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
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 ...
clickbait's user avatar
  • 2,988
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?
Franck Dernoncourt's user avatar
2 votes
0 answers
41 views

Split up a page [closed]

With the move to limit the number of examples in a documentation page, it becomes important be able to easily restructure pages. Please provide a simple way to move an example from one page to ...
Rick James's user avatar
  • 142k
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
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 ...
ThrowingSpoon's user avatar
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 ...
Shog9's user avatar
  • 159k
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 ...
Knu's user avatar
  • 15.1k
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 ...
clickbait's user avatar
  • 2,988
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
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 ...
James Donnelly's user avatar
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
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, ...
Henders's user avatar
  • 1,215
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
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 ...
Bohemian's user avatar
  • 424k
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....
Taylor's user avatar
  • 773
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 ...
Rachel Gallen's user avatar
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 ...
Inzimam Tariq IT's user avatar
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
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 ...
Nikita Kurtin's user avatar
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 ...
Knu's user avatar
  • 15.1k