Hacker News new | ask | show | jobs
by ardalanpouya 1002 days ago
How is design docs different from technical docs?
2 comments

Design docs are for the developpers. Technical docs could also be for the users, by e.g. ending up in some manual or so.
Sorry. In that case I used a bad word. I probably should have said internal docs that explain some specific flow or behavior of the system. A good example is one that onboards new devs.
They are not updated, on purpose. This is the design now.
Is that ideal for example for onboarding new developers? Our challenge is we are are starting to hire but we also move very fast and every time we refer people to our onboarding docs, they come back confused because some essential thing is now deprecated.
Hence clear code with comments on the sharp corners