Kind bookmarks
This is something I strive quite hard to ensure, using tools like html-proofer and comparing against old sitemaps when I change things considerably with my site. It's also something that is quite infuriating when following links to a site that has now rewritten their URLs, so I've learned from that too!
Thanks to Joe Nash for sharing this yesterday, I 100% agree with this - not just on the blogumentation angle, but because making these things visible is really important. And especially now, where every company is a remote company, it makes sense to start building these into your ways of working.
This is a really great interview with Anna Dodson about the great work that Tech Nottingham are doing under both Women in Tech and Tech Nottingham, and is a great read for how they're making Nottingham a much better place to be!
The first answer, [$]
resolved this for me.
This is something I really liked when doing Literate Programming at university. It's really nice to be able to wrap the code with written meaning, in a way that regular comments don't do as well.
A super interesting idea. I've been thinking recently whether I should maybe look at making this site dynamically rendered, but still backed with my site's content being in a Git repo