Full Width [alt+shift+f] Shortcuts [alt+shift+k]
Sign Up [alt+shift+s] Log In [alt+shift+l]
72
Sometimes I joke that as a principal engineer, my main programming language is English. It's half true, though, since my job is as much about people and communciation as it is about technology. Probably more, actually. Writing is useful at all levels of software engineering. It's not just something for tech leads, architects, and principal engineers. We write all the time, whether it's comments in code, descriptions in Jira, messages in Slack, or design documents in a wiki. We don't do this because it's fun; most engineers I've met don't love writing1. We do it because it's useful. I've generally run into four main ways that writing design docs ends up being useful for me and the teams I'm on. There may be more, and there are also ways they're not useful. Here they are with pithy summaries of how they're useful or not, with links to the full sections. Writing a design doc helps you think, leading to better designs. Collaborating on a design doc with teammates improves the...
10 months ago

Improve your reading experience

Logged in users get linked directly to articles resulting in a better reading experience. Please login for free, it takes less than 1 minute.

More from Yale E360

In a First, Solar Was Europe's Biggest Source of Power Last Month

For the first time, solar was the largest source of electricity in the EU last month, supplying a record 22 percent of the bloc's power. Read more on E360 →

20 hours ago 2 votes
In a First, Solar Was Europe's Biggest Source of Power Last Month

For the first time, solar was the largest source of electricity in the EU last month, supplying a record 22 percent of the bloc's power. Read more on E360 →

20 hours ago 2 votes
In Pakistan, a Solar Revolution Is Bringing Power to the People

Fed up with pricey electricity from an unreliable grid, Pakistanis have gobbled up cheap solar panels. In an interview, Muhammad Mustafa Amjad, of Islamabad-based Renewables First, says his country can stand as a model for other nations as they transition away from fossil fuels. Read more on E360 →

3 days ago 2 votes
Pakistan's Solar Revolution Is Bringing Power to the People

Fed up with pricey electricity from an unreliable grid, Pakistanis have snapped up cheap solar panels. In an interview, Muhammad Mustafa Amjad, of Islamabad-based Renewables First, says his country can stand as a model for other nations as they transition away from fossil fuels. Read more on E360 →

3 days ago 2 votes
Pakistan's Solar Revolution Is Bringing Power to the People

Fed up with pricey electricity from an unreliable grid, Pakistanis have snapped up cheap solar panels. In an interview, Muhammad Mustafa Amjad, of Islamabad-based Renewables First, says his country can stand as a model for other nations as they transition away from fossil fuels. Read more on E360 →

3 days ago 2 votes

More in programming

Computers Are a Feeling

Exploring diagram.website, I came across The Computer is a Feeling by Tim Hwang and Omar Rizwan: the modern internet exerts a tyranny over our imagination. The internet and its commercial power has sculpted the computer-device. It's become the terrain of flat, uniform, common platforms and protocols, not eccentric, local, idiosyncratic ones. Before computers were connected together, they were primarily personal. Once connected, they became primarily social. The purpose of the computer shifted to become social over personal. The triumph of the internet has also impoverished our sense of computers as a tool for private exploration rather than public expression. The pre-network computer has no utility except as a kind of personal notebook, the post-network computer demotes this to a secondary purpose. Smartphones are indisputably the personal computer. And yet, while being so intimately personal, they’re also the largest distribution of behavior-modification devices the world has ever seen. We all willing carry around in our pockets a device whose content is largely designed to modify our behavior and extract our time and money. Making “computer” mean computer-feelings and not computer-devices shifts the boundaries of what is captured by the word. It removes a great many things – smartphones, language models, “social” “media” – from the domain of the computational. It also welcomes a great many things – notebooks, papercraft, diary, kitchen – back into the domain of the computational. I love the feeling of a personal computer, one whose purpose primarily resides in the domain of the individual and secondarily supports the social. It’s part of what I love about the some of the ideas embedded in local-first, which start from the principle of owning and prioritizing what you do on your computer first and foremost, and then secondarily syncing that to other computers for the use of others. Email · Mastodon · Bluesky

2 days ago 3 votes
New Edna feature: multiple notes

I started working on Edna several months ago and I’ve implemented lots of functionality. Edna is a note taking application with super powers. I figured I’ll make a series of posts about all the features I’ve added in last few months. The first is multiple notes. By default we start with 3 notes: scratch inbox daily journal Here’s a note switcher (Ctrl + K): From note switcher you can: quickly find a note by partial name open selected note with Enter or mouse click create new note: enter fully unique note name and Enter or Ctrl + Enter if it partially matches existing note. I learned this trick from Notational Velocity delete note with Ctrl + Delete archive notes with icon on the right star / un-star (add to favorites, remove from favorites) by clicking star icon on the left assign quick access shortcut Alt + <n> You can also rename notes: context menu (right click mouse) and This note / Rename Rename current note in command palette (Ctrl + Shift + K) Use context menu This note sub-menu for note-related commands. Note: I use Windows keyboard bindings. For Mac equivalent, visit https://edna.arslexis.io/help#keyboard-shortcuts

2 days ago 3 votes
Thoughts on Motivation and My 40-Year Career

I’ve never published an essay quite like this. I’ve written about my life before, reams of stuff actually, because that’s how I process what I think, but never for public consumption. I’ve been pushing myself to write more lately because my co-authors and I have a whole fucking book to write between now and October. […]

3 days ago 9 votes
Single-Use Disposable Applications

As search gets worse and “working code” gets cheaper, apps get easier to make from scratch than to find.

3 days ago 7 votes