• Home
  • Blog
  • Projects
  • Bookshelf
  • About
← Back to all status updates

All Documentation Should Be Dated

Published 📅: ....
Last modified 📝: ....
Location 📍: Boston, MA

Share this status update on BlueskySee discussion on Bluesky


The title basically says it all - if you manage docs (specifically a documentation website), your docs should show the date and time of when the docs were created and last updated.

I'm sure most of us have been looking at some docs for a library or feature and then find out later through experimentation or when talking with coworkers that those docs are at least 6+ months out of date.

Add a quick timestamp at the top of the page showing when the docs were created (and also add one for when the docs were last updated)!


Tags:

micropost

Bluesky Post and Comments:

Loading comments...

Related Posts

micropost

<Blank> Driven Development

Published: ....

Adding Microposts

Published: ....

Service Monitors and Observability

Published: ....

Leveraging service monitors properly to improve service observability.

Being Unopinionated

Published: ....

It's fine for a library to express some opinions about how it should be adopted and how the overall workflow/application in which it is adopted should function. However, it's false advertising to say that it is unopinionated.

Stop Snacking

Published: ....

No I don't mean those Milano cookies you keep taking from the office snack wall either (although you should probably stop snacking on those as often as well).

No Process is Invisible Process

Published: ....

Low/no process workflow wasn't actually no process, it was only an "invisible" process. An implicit contract with everyone on the team to do that async workflow on their own time.

Matt Hamlin

Matt Hamlin

@matthamlin.me

Quick micropost:

All documentation should be dated

matthamlin.me/2025/june/al...
All Documentation Should Be Dated

All Documentation Should Be Dated

https://matthamlin.me/2025/june/all-documentation-should-be-dated
6 days agoView on bsky.app
0
1
0
0