Hacker News new | ask | show | jobs
by 8note 780 days ago
It's definitely given me the opinion that the only reliable docs are what's in git.

Links to stories are useless

Links to tickets are better

Links to wikis are awful

Comments are misleading

Code review links are ok, but mostly link to unreliable sources, and older code review links are gone.

Commit history also goes missing, so don't bother leaving too much info in the commit text

Current code is mostly reliable, but might need extra knowledge to actually reason about.

It's crazy how much useful info get deleted or not migrated or gets moved in a way where you'd never find it again, or the search tools stop indexing it

1 comments

Spent almost 12 years at Amazon till early 2023 and some of this is very surprising to me.

I know the annoying slack retention policy but I had never heard of tickets, issues, or wikis or even git commits being auto deleted.

When I was there I could go back a decade and open up old tickets or wikis.

Has things changed so much in less than two years?