282

Well, November 2016 sure was a month that happened.

Now that we're on the other side of the US election and holidays (and the team is back at work) it's time for an update on Stack Overflow Documentation.

View the previous update.

Shipped

Topic Introductions

Every topic now has an optional section above examples, an Introduction.

Introduction in the editor

Introductions should give readers an idea of what they're going to find on a topic, and help future contributors tell what belongs.

Improvement Requests

Improvement request have been updated.

Improvement request flow

For each type of a request, only a single one can be active on any given example or topic. Improvement requests can now be commented on. The entire improvement request element can also be collapsed, to save vertical space.

Introduction Topics Standardized

Introduction Topics (also known as Hello World topics, Root topics, Overview topics, etc.) now have a standardized title and display.

Intro topic style

The title is based off the friendly name of a tag, which can be edited by highrep users (anyone who has the trusted privilege) on a tag's wiki.

Planned

Discussion

Another round of user testing has wrapped up on the (oft discussed) Discussion feature. Thank you to those who participated, we've got a final design now.

Here's an updated mockup.

Discussion mockup

Proper implementation will start this week. It's a complicated feature, but it'll make a good present for the holidays.

Topic/Example Menu De-Iconizing

We're going to be converting the menus in Documentation to display more like the menus on Q&A.

Basically

New menus

We'll also be moving these menus to a more familiar position.

Moving Topics

We're going to be adding an option in the coming weeks to move whole topics to different tags as part of a change. This option will live in the "move examples"-popup currently at the top of a topic.

16
  • 11
    I'm a bit confused… 20 upvotes AND an SE staff member saying it was on the to-do list here… and it's not even listed as planned here?
    – Nissa
    Commented Nov 29, 2016 at 17:58
  • 54
    Why is there a 500 character length limit on introductions? In JS Unary Operators, I (ab)used an pinned example as "Introduction", but just the markdown for the links in there is already 700 characters. The pinned example is an easy-to-browse index that really should be in the introduction.
    – Cerbrus
    Commented Nov 29, 2016 at 19:52
  • 7
    ^ Even that comment is already 300 characters (Not counting the link).
    – Cerbrus
    Commented Nov 29, 2016 at 20:03
  • @Cerbrus that should probably be a separate question.
    – Nissa
    Commented Nov 29, 2016 at 20:06
  • 18
    @StephenLeppik: I've got multiple documentation bug reports open. I'd rather directly comment on a recent change, than having another report fade into nothing.
    – Cerbrus
    Commented Nov 29, 2016 at 20:08
  • 13
    Nice and all, but I would seriously love to see this implemented. It would be incredibly helpful for this to work like suggested edits and for at least reject votes to be shown while the change is still pending. At least getting some dev feedback on if that idea's likely to ever happen would be great...
    – Kendra
    Commented Nov 29, 2016 at 20:21
  • 5
    I would love it if this issue I reported 4 months ago was fixed. It kinda blows my mind that it's still there...
    – DavidG
    Commented Nov 30, 2016 at 1:09
  • @StephenLeppik According to an edit on that post 5 hours after you posted this, it has now been implemented.
    – SGR
    Commented Nov 30, 2016 at 8:49
  • @SGR I know. I get notified when someone edits my post.
    – Nissa
    Commented Nov 30, 2016 at 13:43
  • @Cerbrus I promise we're looking at all Documentation bug reports even if there's no immediate response. For us to remember that the issue exists and to track community support (through votes, answers, etc), a separate question beats a comment on a temporally-relevant feature announcement any day.
    – Adam Lear StaffMod
    Commented Dec 2, 2016 at 4:27
  • 2
    @Cerbrus If I recall, the reasoning for the length limit was to prevent the intro section from growing too large to really be called an intro. We did, however, pick a number sort of out of a hat, so some adjustment is possible if there's a need. [status-beta] and all. (Or we could build something else that addresses said need.) Not to harp on the same point, but this is also where a separate question shines since examples of whatever needs aren't being served can be gathered, discussed, etc.
    – Adam Lear StaffMod
    Commented Dec 2, 2016 at 4:28
  • @AdamLear: Thanks for the reply. I've submitted a feature request to increase the limit. (Figured it's not really a "bug")
    – Cerbrus
    Commented Dec 2, 2016 at 7:54
  • 1
    "request improvement" as a two-word link just doesn't feel right. "flag" would be inappropriate here. I know there's already "improve this question" for anonymous users on the main site, but there are fewer other links there. Maybe someone could think of a one-word link that fits well there. Commented Dec 3, 2016 at 14:12
  • 4
    I like the idea of SF Documentation. But I must say I'm a bit underwhelmed with how it is evolving. I've contributed a couple of times mainly to get a feel for it. No edits, upvotes or anything. My impression with most topics I've looked at is that there is indeed not a lot happening and the little that is happening is of little interest to anyone. I think the whole approval/review bureaucracy is just holding things back currently. I'd suggest removing the feature completely and simply rely on up votes/down votes for quality based filtering. There's too much friction currently. Commented Dec 9, 2016 at 13:04
  • when will the Comments be online?
    – user6754053
    Commented Dec 10, 2016 at 14:50

0

Browse other questions tagged .