Category: Contentions
-
Docs, branding, and opinions
There’s a reason writing amplifies the abilities of software companies, and it’s not (just) the marketing. I’ve previously put forward the idea that great writing is an extension of the product, in which I talk about documentation and brand voice. I neglected to mention a key factor: Most people don’t know what to do with…
-
Fingerprints
In The Undoing Project, Michael Lewis writes of Amos Tversky and Daniel Kahneman’s collaborative writing: By the time they were finished with the paper, in early 1970, they had lost any clear sense of their individual contributions. It was nearly impossible to say, of any given passage, whether more of some idea had come from…
-
Contentions: Advocacy, ambassadorship, and relations
Amazon famously has an empty chair in each meeting, a quiet symbol that represents the customer. That’s not enough anymore. An empty chair won’t share a perspective or have a point of view. It won’t be able to tell you something you didn’t even know you didn’t know. That’s where people who work in advocacy,…
-
World building
A decade ago, Donald Glover said, “You’ve got to build a bigger world. I’m not gonna make [just] an album; I’m gonna make an album, I’m gonna make the roll out dope, I’m gonna make the movie with it dope, I’m gonna make everything dope. I’m gonna make a world.” This approach is what led…
-
Documenting Config
My colleague Jenny and I have been busy documenting Config here at the new Figma blog, Shortcut. Because you can already watch many of the sessions here, we decided to approach it with an emphasis on the atmosphere and the experience.
-
Medium Day topics
Medium recently announced a call for Medium Day, which takes place August 12. When I wrote my first post for Medium, over a decade ago, I was in between graduating college and my first job at Pivotal Labs (and even tried to make Medium a part of its content strategy). I received an invitation to…
-
Contentions: Track your rewriting
When I edited my book Creative Doing with Rachel and the Holloway team, we worked together mostly in two different documents. Cumulatively, there were 3,016 suggested changes and 240 comments across both documents. Those numbers sound reasonable to me, though I wouldn’t be shocked if that’s an underestimate; we spent a lot of time on…
-
The only way to change someone’s mind
“Getting a prospect to admit their “mistake” borders on the impossible. All you’ll do is irritate or antagonize your prospect. That is not the way to persuade them to buy from you.… No, the prospect won’t change their mind, but they will be delighted to make a new decision, based on new information,” writes Zig…
-
Getting to know a business
If you’ve ever wanted to start a company, or write a book, or make something meaningful, it helps to go through the process as the person who’s paying for it. If you’re starting a company, figure out your potential competitors and see if you can work with them as a customer. If you want to…
-
Contentions: Names set expectations
What’s the difference between a book, an ebook, a digital book, a pamphlet, a booklet, a brochure, and a bulletin? By strict definition, they share a lot of common traits. They are all documents that hold words on them. The main difference is what each word leads a person to expect. For example, a book…