In a sense, true. Diagrams can be part of an operating procedure however - why n... | Hacker News

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

		willtemperley on Jan 23, 2023 \| parent \| context \| favorite \| on: Guide to Software Architecture Documentation In a sense, true. Diagrams can be part of an operating procedure however - why not even write operating procedures for architects? Checklists to ensure they've consulted with developers, product owners and site reliability engineers. Checks to ensure the diagrams are up-to-date and actually useful.

robertlagrant on Jan 23, 2023 [–]

I don't see why you're talking about operating procedures. This is about good diagram / documentation formats. Nothing to do with checklists or SOPs.

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