News for hackers. Stuff that matters.
Re:Ask HN: Are System Design documents out of fashion? by throeawayDocs on Wednesday January 19, 2022 @09:48PM (#30003813)
This is an interesting perspective that I hadn’t considered.

My colleagues all seem happy in their roles, although they work in countries with less workers rights/securities(?) than in my own country. Maybe they don’t document anything so they are seen as “sticky”.

However I do wonder how they would feel if they were blocked from taking a new internal role because they’re deemed too essential, because they’ve not documented anything.

Re:Ask HN: Are System Design documents out of fashion? by themodelplumber on Wednesday January 19, 2022 @10:00PM (#30003919)
Yep, it's tricky...It could also be that there's a need for clarity, for example a minimum objective level of architecture documentation and test-passing... It might help take the pressure off of individuals who have a high personal standard of work, with little perceived recompense from the org.