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++ ...
John Bargman's user avatar
  • 1,266
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 ...
LWChris's user avatar
  • 3,350
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 ...
Suragch's user avatar
  • 486k
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>...]]`
Shog9's user avatar
  • 157k
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 ...
Tim Post's user avatar
  • 33.4k
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 ...
Kevin Montrose's user avatar
5 votes
Accepted

Version selection buttons are unclear

We've updated the style to make it more clear which versions are selected:
Kurtis Beavers's user avatar
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 ...
yitzih's user avatar
  • 3,018
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 ...
Kartik Chugh's user avatar
  • 1,104
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
Frank's user avatar
  • 66.2k
4 votes
Accepted

Overlapping error messages

Starting with the next build, we'll combine multiple errors on the same item:
Adam Lear's user avatar
  • 38.2k
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 ...
wizzwizz4's user avatar
  • 6,150
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.
SeinopSys's user avatar
  • 8,797
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.
ivarni's user avatar
  • 17.7k
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 ...
svarog's user avatar
  • 9,527
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 ...
Jon 'links in bio' Ericson's user avatar
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!
Adam Lear's user avatar
  • 38.2k
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 <...
Jed Fox's user avatar
  • 2,979
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 ...
animuson's user avatar
  • 53.9k

Only top scored, non community-wiki answers of a minimum length are eligible