32
votes
Accepted
Why is Documentation not ordered in any discernible way?
There is no mechanism to order documentation currently.
However I greatly believe there should be, the C++ vector is a perfect example of why!
Compare the C++ reference website to the Current C++ ...
20
votes
Documentation should make proposed edits more clear to other editors
Since SO-Docs are somewhat comparable to Wikipedia articles - many people (partially) edit community content - their solutions to this problem might work for SO, too.
In Wikipedia, if an article has ...
19
votes
Why is Documentation not ordered in any discernible way?
I agree that it would be better if there were an order.
There is currently no ordering by design:
We don’t really think, based on observation and personal experiences,
that there’s a ton of ...
13
votes
Accepted
Syntax must be formatted as a list of one-liners
Looks like the problem is the code formatting. Use inline code instead:
- `git pull [options [<repository> [<refspec>...]]`
7
votes
Accepted
Documentation peer review
One of the things identified as being needed is a more formal kind of review system, which is pretty high on the list of stuff that we're going to be working on.
I don't have concrete details on how ...
7
votes
Accepted
Is there any way to see my minor and major contributions as a list in documentation?
The contributors tab on your profile now list major and minor contributions*.
As part of this change, the proposed changes tab lists all changes (approved, rejected, or still pending review).
* Note ...
5
votes
Accepted
Version selection buttons are unclear
We've updated the style to make it more clear which versions are selected:
4
votes
Why is Documentation not ordered in any discernible way?
As it currently exists there isn't really a way to order the topics/examples. How would it even be possible? Should an explanation on objects come before or after an explanation of loops and selection ...
4
votes
Why is Documentation not ordered in any discernible way?
I think the best way to order things would be a tree diagram -- there is a basic "trunk", with intro stuff, and after that it branches out into branches, stems, leaves, etc. Some opposition to the ...
4
votes
Accepted
Documentation new topic: Where did my draft go?
You can find your current drafts at
https://stackoverflow.com/users/current?tab=documentation&sort=topicdrafts
4
votes
Accepted
Overlapping error messages
Starting with the next build, we'll combine multiple errors on the same item:
3
votes
Documentation should make proposed edits more clear to other editors
We could use the Git technique: if there are two commits from the same base, they are (usually) merged on a line-by-line basis, or merged manually in the event of a conflict.
For example, if user one ...
2
votes
Image isn't correctly rendered
The issue seems to have been caused by additional text following the line which had the image link reference. I've made an edit that fixes this by adding a new line directly after the image link.
2
votes
Accepted
How to remove example?
There's a little Flag icon next to the title, just two icons over from the Edit icon. Users handling that request should be able to delete it completely.
2
votes
Why is Documentation not ordered in any discernible way?
Of what I've seen notable examples are pinned to top.
On the more popular documentation pages (C#, Java..) the amount of topics can reach approx 150, that's about 8 pages.
Currently the orders are by ...
2
votes
Accepted
Adding code block into introduction
Introductions are severely limited because are intended to be quick signposts of what the topic is about. It's directly analogous to tag wiki excerpts. If you feel the need to add code, it's a good ...
1
vote
Documentation - Can't edit many sections of draft
We had an issue where the editor placement code wasn't being triggered correctly.
A fix is out now. Please let me know if you're still running into problems with edit links. Thanks!
1
vote
Accepted
Documentation - Version is not valid in this context
Your problem seems to be this line:
<!-- if version <Python 2.x> [gte > 2.0] -->
The problem is the > in [gte > 2.0]. To fix, replace with this line:
<!-- if version <...
1
vote
Accepted
HTML Comments in Document examples are there any rules to their use?
It's neither. It's just something that some people like to do if they deem it necessary, and has been known for years in all places that allow some HTML in the Markdown. What you're really doing is ...
Only top scored, non community-wiki answers of a minimum length are eligible
Related Tags
documentation-editor × 33documentation × 32
bug × 14
discussion × 9
support × 8
feature-request × 7
status-completed × 4
documentation-drafts × 3
documentation-topics × 2
documentation-proposals × 2
design × 1
reputation × 1
status-bydesign × 1
stack-snippets × 1
markdown × 1
user-experience × 1
markdown-rendering × 1
review-queues × 1