Hacker Newsnew | past | comments | ask | show | jobs | submitlogin
Ask HN: How do you document your architecture?
3 points by bow_ on March 8, 2019 | hide | past | favorite | 1 comment
I'm wondering if there are any best practices to document your software architecture design. Related to this, are there are any public examples of a good software architecture documentation?


I've had to explain our architecture to new hires a while ago, and it was a real mess. I was screen sharing while talking and drwing an ugly graph in inkscape at the same time.

It gave me an idea though, I'm working on a project that'd turn a plain text document (dot language style) into an narrated video made up of graphs showing how things work, who does what when..

Idk if there's a market for that but it's really fun to program anyway :)




Consider applying for YC's Winter 2027 batch! Applications are open till November 2.

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: