Nine Tips on Writing Empathetic Documentation for Web Developers

During my time as a frontend designer at Sparkbox, I worked with their skilled editing team to turn some of my opinions into practical advice. This article is Part 2 to my thoughts around documentation. It’s preceded by Part 1, Empathy, Meet Documentation.

I recommend taking a look around Sparkbox’s foundry as you’ll find many great thoughts on design and development there. You can find both mentioned articles of mine there as well:

Previous
Previous

Design Tokens: An introduction to tokens and how they are used in design systems

Next
Next

Empathy, Meet Documentation