Jacob Kaplan-Moss
Activity tagged “writing”
Bookmarks
Longform.org
Collecting some of the best long-form journalism available on the web. With bonus Instapaper integration!
Neil Gaiman's Journal: Why defend freedom of icky speech?
“If you accept — and I do — that freedom of speech is important, then you are going to have to defend the indefensible. That means you are going to be defending the right of people to read, or to write, or to say, what you don't say or like or want said.”
Threepenny Planet: Muphry's Law
“Muphry's Law dictates that if you write anything criticizing editing or proofreading, there will be a fault of some kind in what you have written […]”
Rands In Repose: The Coffee Mug Affair
Rands is starting to remind me of a geeky Haruki Murakami, documenting the minutiae of daily life in glowing prose. Naturally I love it.
idiosynchrony
My friend Jocelyn Rice has just started a blog. She's an amazing writer; if you like good science writing, I suggest you check it out. Who knew there was actually an established formula for calcuating the surface area of an elephant?
Rands In Repose: The Gel Dilemma
This is why Al Gore invented blogging.
Mike Davidson: A Low-Fi Solution to E-Mail Overload: Sentenc.es
Really, really tempting.
Entries
You need an editor
If you really want to produce great documentation, it needs to be edited.
Technical style
How to develop a great technical writing style.
What to write
Tech docs can take a bunch of different forms ranging from high-level overviews, to step-by-step walkthroughs, to auto-generated API documentation. Unfortunately, no single format works for all users; there’s huge differences in the way that people learn, so a well-documented project needs to provide many different forms of documentation. This is the first in a series of posts that’ll cover the art of writing good technical documentation.