I've always appreciated Stephen King's advice on writing. So much so that I once bought a jacket with a tiger on the back because he suggested that it was a good way to build confidence as a writer¹ (see George Stark in The Dark Half). Another piece of advice from King is this handy rubric for editing: "cut 10%"... or in the words of his high-school era editor:

“Not bad, but PUFFY. You need to revise for length. Formula: 2nd Draft = 1st Draft — 10%. Good luck.”

This is solid advice, but as you might guess there is a lot more to editing than making things shorter.

In a previous article I discussed the need for a data driven approach to TechDocs. This article will discuss one possible documentation metric: Total Time Reading (TTR).

In the recent months, I have been working with @calebhailey.com to develop a new kind of workflow for posting to the Internet. Traditional social media has problems with content ownership, but what they get right is the user experience.

It is trivial to open up Twitter or Instagram or Facebook or LinkedIn or any number of other sites using their mobile app and make a quick post hit send and have it go live on a public facing feed somewhere on the Internet that other people can see.

Doing something this basic is unfortunately quite difficult if you own your own website and domain. Caleb and I think that’s a problem, and that you should be able to post to your own website as easily as you post to Twitter.

Recently, at AppFog, we encountered a series of abusive users attempting to cause havoc by flooding UDP.

Some basic iptables settings can prevent this kind of thing from happening.

Key Words and Phrases: documentation, knowledge sharing, engineering culture, technical writing, user experience (UX), product culture

Background

For those of you familiar with my community and professional work—as a co-founder and organizer of the Write The Docs conference (2013-2015), as an outspoken advocate for documentation, and as the Technical Lead (TL) of Twitter's internal TechDocs team (2014-current)—this publication may come as a surprise. It is precisely these professional experiences which have led me to the understanding that I have today: that documentation may in fact be more harmful than it is helpful.