It is time for 2017's first major upgrade to Stack Overflow Documentation — a new Discussion feature plus some other improvements to menus, spam-prevention, review audits and the ever-popular vote split view.
Shipped
Discussion
Every topic now has a discussion page.
The discussion tab aggregates all the different things that are happening or have happened to a topic, and provides a way to discuss them.
- Each Example on a topic gets its own entry. Example comments remain open as long as the example is undeleted.
- Comments on Changes are also surfaced. Once a change has been reviewed, its comments are closed.
- Likewise, Improvement Requests are surfaced along with their comments. Once an improvement request is handled, its comments are closed.
- The original Topic Request, if any, along with any comments on it is also included. By the time a topic request appears on a discussion page it's already been handled, so its comments are closed. It's surfaced because some relevant discussion may have occurred on it.
- General Discussions entries (created via the New Discussion button) - for anything not covered by the automatic discussion items. General discussion comment threads close 14 days after the last comment was made.
You can filter and sort at the top of the discussion page.
Watching Discussion and Managing Notifications
Discussion item comment notifications work how'd you expect, the owner is always notified and the first participant @mentioned
, if any, is also notified.
But, we have these eyes all over the page.
They let you opt-in to additional notifications.
If you subscribe to a particular item, you'll be notified of all new comments on that one item.
If you subscribe to all discussions on a topic, you'll be notified of all new comments and all new discussion items (proposed changes, improvement requests, and general discussions).
Based on the number of requests we've seen for ways to monitor a topic, we've also decided to opt anyone who makes a non-trivial change (read: has the potential for rep gain) into watching the topics they edit. These opt-ins have been backfilled.
You can manage all of your documentation notifications (including those from subscribing to a tag's documentation dashboard) through the new "watching" tab on your profile.
Text Menus
As announced a bit ago we've replaced the icon menus and removed the default collapsing of examples. This was originally planned due to confusing resulting from the placement and meaning of certain icons, but we also ended up needing additional room to add a link to each example's discussion and the whole topic discussion tab.
Top of topic menu:
Example menu:
This took a surprising amount of work, and lots of changes to some very old assumptions in the editor code. We expect there to be some bugs that slipped through, so do please report any you find.
General spam improvements
Behind the scenes, we've hooked Documentation into most of the anti-spam systems that we're originally developed for Q&A. It's unlikely you'll notice anything in particular change, but it does mean that spamming Docs will now result in a Q&A ban (and vice versa).
One visible change is a new dismiss reason for topic requests.
Additional Penalties for Failed Review Audits
Failing audits will now undo some recent reviews, in addition to the existing temporary ban.
Show Vote Split
A privilege from Q&A has been implemented in Documentation: the ability to see the breakdown of up and down votes on an example.
Planned
Moving Topics Between Tags
This is still planned. We've been hung up by issues with how search works, but we're making progress. This option will be a tab under the existing Move Examples dialog.
More Spam and Moderation Related Features
We're continuing to work on spam and moderation tools. We'll be rolling out more updates on this in the coming weeks.