Documenting design changes with screenshots
jamesg.blog·4h
🎨Design Tokens
Preview
Report Post

Published on 12 January 2026.

While I was writing “Publishing my citation preferences”, I consciously decided that the blog post should include a screenshot of the website feature described in the post – the new “Reference this post” section on my blog pages. I knew that I might change the design of the widget I designed in the future. If I did, how would that affect the readability of my blog post? I thought to myself.

By including a screenshot of the widget I had designed in my blog post, I knew that there would be a constant frame of reference for the reader. Even if the style of the page changed, the screenshot documents, at the point in time in which I wrote the blog post, how the widget …

Similar Posts

Loading similar posts...

Keyboard Shortcuts

Navigation
Next / previous item
j/k
Open post
oorEnter
Preview post
v
Post Actions
Love post
a
Like post
l
Dislike post
d
Undo reaction
u
Recommendations
Add interest / feed
Enter
Not interested
x
Go to
Home
gh
Interests
gi
Feeds
gf
Likes
gl
History
gy
Changelog
gc
Settings
gs
Browse
gb
Search
/
General
Show this help
?
Submit feedback
!
Close modal / unfocus
Esc

Press ? anytime to show this help