Skip to Content


All journal entries tagged with ‘#documentation’

Related Journal Entries

About Those Docs

Daniela Baron writes up some great advice and a thorough list for thinking about documentation on a project.   It’s one of those where you find yourself aggressively nodding along, but there’s one that really stuck out because it feels so often overlooked. So often, people focus on well-written code not needing extensive documentation, and that can be partial true in terms of understanding what the code is doing.

Good names and understandable code can’t, however, explain the why of how a certain section of code is written. We talk about making sure code can be intention-revealing, but it’s never going to be able to communicate the state and context of the project at that specific point in time and how that informed the approach.

Documenting Interface Design

Use cases, functional specs, interface specs, site maps, you name it. I have yet to come across any of these documents that are usable. I’m as guilty of this as the next person, but if our job as information architects, interaction designers, or…