Mike English on preferring written communication for remote teams:

Generally speaking, remote-first communication means preferring written, searchable methods of communication that work even when the sender and receiver aren’t engaged at the same time.

Every meaningful conversation should have a URL, even if it's only a summary of a face-to-face meeting after the fact. Seeing the conversation leading up to unpopular decisions builds trust.

This means that phone calls, while potentially much better at conveying tone and establishing emotional connections, cannot be the default method of connecting with teammates.

Phone calls and hangouts have their place. Tone is important. It's more difficult to convey in writing but it can be done.

Chris Coyier's list of words to avoid in educational writing made me wince because I catch myself using them too often. Technical writing suffers when the text assumes the audience shares the author's experience or context.

Whether I'm working on docs, guides, or books, Vim is my jam. In order to curb my use of these weasel words, I added some formatting rules to my dotfiles.