Ask HN: Examples of good technical design docs
As part of an interview process, I have recently received a take home assignment of writing a technical design doc for a simple web app. Turns out I badly suck at it.
I have found resources describing the templates, the "hows" and "whys" of TDD, but I struggle to find some actual, real-life examples.
Can you recommend any good technical design docs? Or any other resource that would make you better at writing such documents?
(
5 comments
| 14 points
| on HN
)
https://www.industrialempathy.com/posts/design-docs-at-googl...
also if you just Google the 2 words "design docs" there's actually a surprising amount of useful things that pop up
However, what I'm looking for are not the articles about writing technical design but the actual design documents. Preferably ones that are considered well written by the community.
https://sites.nationalacademies.org/cs/groups/pgasite/docume...
{I'm not sure if there is a golden sample that can be referred to. Gitlab has some good docs as well. Maybe that will help?}
* https://github.com/jenniferlynparsons/awesome-writing
* https://www.divio.com/blog/documentation/