May 2017
Much of May was dedicated to rethinking our strategy which culminated in the Tearing Down the Structure of Documenation meta post. Vasudha also began the Discovery phase by asking What T-SQL documentation has helped you? Most of June will be taken up with Discovery tasks such as gathering input from developers within the company, Stack Overflow users and technical writers.
That said, we did wrap up two quality-of-life features that ought to improve Documentation no matter how it looks in the future.
Redesigned review page
One persistent problem we've seen from meta reports and user interviews is reviewers not knowing exactly what they are approving or rejecting. We think part of the problem is the somewhat disjointed layout of the review page:
Among the issues we identified:
- diff view controls were widely separated from the content itself
- reviewers sometimes overlooked revision comments
- automated summaries of changes could be unclear
- the possible plagiarism warning didn't have a logical place to be displayed
Our newest designer, Aaron Shekey, worked with Adam Lear to rebuild the page:
There's still some work to be done (including something Aaron calls "polish"), but we think this already makes review more useable and understandable.
Flag all the things!
Meanwhile, Jarrod has been making it possible to flag all types of Documentation content for review. For a long time we assumed/hoped proposed changes would allow us to avoid moderator flags. But after adding discussion, it became clear we'd need some way to signal serious problems. As of June 9th, you can flag comments:
Topic requests:
Examples and Topics:
For the moment, these flags are only visible to employees while we work out any problems.