Well in that case, the docs are written separately to the code is just a lazy wa... | Hacker News

Hacker Newsnew | past | comments | ask | show | jobs | submit

		Lio on Jan 12, 2023 \| parent \| context \| favorite \| on: Architecture diagrams should be code Well in that case, the docs are written separately to the code is just a lazy way of saying the docs do not reflect reality or are out of date. Waterfall development doesn't work. It doesn't really work for specs and it doesn't really work for documentation either.

baby on Jan 12, 2023 [–]

Not sure what waterfall dev has to do with that, and "the docs do not reflect reality or are out of date" is always true (even if within the code).

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