Skip to main content
2 of 9
Typos
Benjamin W.
  • 51.6k
  • 2
  • 14
  • 20

Documentation Update, September 29th

This is the fifth post in our series of regular (roughly fortnightly weekly) updates on the Documentation Beta. See also the previous post in the series.

Shipped Changes

Reputation

As announced elsewhere, Documentation's reputation system has been updated. Lots of time since then has been spent on bug fixes, and we're still crushing a couple outstanding ones.

Retract proposed changes from dashboard

It's in the cog menu

It is now possible to retract a proposed change (allowing edits to the draft) without revisiting the topic involved.

A similar option is on its way to the review queue.

Topic Outline

The first parts of the Topic Outline have shipped.

enter image description here

Side-by-side view (where examples were displayed on the right) has been removed as part of this.

Topic Outline sizes itself at page load to keep other sidebar content visible if possible, so community bulletin (and related content, and eventually ads) aren't pushed too far down the page by its addition.

Planned Changes

Review Audits

Audit tasks will start showing up in the Proposed Changes review queue in the next week or so.

Additionally, we're going to start consuming more history to trigger those audits, as well as restrict access to review (and potentially proposing changes in the first place). We're still analyzing various cases, so expect to hear more about these changes even after audits ship.

Discussion

We've started recruiting users for (very early, mockup based) testing of the previously announced discussion feature. If you're interested, hit up Jon in chat.

Here's an updated mockup:

Discussion v... 4?

Focus section

Work has begun on the focus section, expect to see it in the coming week or so.

Improvement Request changes

We're going to be making some changes to Improvement Requests to clear up some confusion around them.

First, we're going to only allow a single active improvement request on a topic or example per type of request. Each active improvement request will allow comments for further discussion, elaboration, or concurrence.

Improvement request display

Second, the post-downvote prompt is being redesigned to make it clear that your downvote can have an improvement request attached.

New downvote prompt

Kevin Montrose
  • 22.6k
  • 24
  • 76
  • 74