News for hackers. Stuff that matters.
Re:Ask HN: What breaks first when your team grows from 10 to... by bsjshshsb on Wednesday March 18, 2026 @07:28AM (#47424310)
Art is knowing what to document. And how to organize it. This is probably not a solved problem and needs constant care and refactoring like the code itself.

Giving people additional documented responsibilities helps. Lucy is responsible for API docs and swagger up to date and for building that out as business needs. Varun is responsible for coding practices docs. And so on. If something is out of date they update it. Use Confluence or Notion or something else good.

Re:Ask HN: What breaks first when your team grows from 10 to... by jacquesm on Wednesday March 18, 2026 @08:11AM (#47424708)
Agreed in principle, but I think the real art is to keep it up to date over the longer term.