Writing
the curse of knowledge. It’s almost impossible to imagine not knowing what you know. Therefore, it’s a challenge to put yourself in the same position as your reader.
Doug Kessler • How to Write Clearly
Every piece of writing offers the reader a deal. In return for their time and attention, they receive some sort of value.
Doug Kessler • How to Write Clearly
The editor, then, is a connector—a conduit from writer to reader—but also a translator, improving the communication from each to the other.
Peter Ginna • What Editors Do: The Art, Craft & Business of Book Editing (Chicago Guides to Writing, Editing, and Publishing)
When people say, "I was writing all day," they don't mean they were intermittently typing for eight straight hours. They mean they spent the entire day engaged in the writing process. And a big part of that process is installing, configuring, and testing software—in other words, learning.
Andrew Etter • Modern Technical Writing
Every tech writer knows two basic things about our work: We spend only a fraction of our time actually writing. The information development cycle is circular and continuous.
Splunk Documentation Team • The Product is Docs: Writing technical documentation in a product development group
Simplicity isn’t just a visual style. It’s not just minimalism or the absence of clutter. It involves digging through the depth of the complexity. To be truly simple, you have to go really deep. For example, to have no screws on something, you can end up having a product that is so convoluted and so complex. The better way is to go deeper with the... See more
Walter Isaacson • Steve Jobs
complexity first, simplicity second
people say “keep it simple,” but most approach it backwards. they start from simple, then add on complexity without seeing the whole. that’s how you end up with frankenstein products: clean-looking components awkwardly stitched together, held in place by duct tape and wishful... See more
ryolu_x.com