News for hackers. Stuff that matters.

throeawayDocs

Re:Ask HN: Are System Design documents out of fashion? on Thursday January 20, 2022 @05:28PM (#30016163)
Have you seen any open sourced standard templates? Would you be interested in collaborating on one?
Re:Ask HN: Are System Design documents out of fashion? on Wednesday January 19, 2022 @09:57PM (#30003898)
Appreciate your input. Perhaps it is seen as a waterfall way of doing a things. Personally I would write it alongside building the system, then continue to evolve it as the architecture matures. It does not need to be a case of writing everything down first before building things. Although it might be cheaper to change the words in the document compared to destroying Infra and rebuilding it!

This can then be used to show customers or auditors that we have been diligent and designed the system carefully, even if they find some flaws.

Re:Ask HN: Are System Design documents out of fashion? 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.

Ask HN: Are System Design documents out of fashion?

I’ve been hopping around a number of large non-FAANG enterprises for the past few years. In each, I keep observing a pattern - people seem uninterested in writing System Design / Architecture documentation.I struggle to grok a system if I can’t read about the context. What are the goals/antigoals? What constraints was the system built under? What big architectural choices were evaluated? (e.g...

( Read More... | 25 comments | 39 points | on HN )