Re:Launch HN: IcePanel (YC W23) – Onboard engineers with exp...
by Mandatum on Thursday January 12, 2023 @04:05AM
(#34350943)
As a consultant, I love this.
As an employee however; nobody on my team, nor my projects, nor my wider organisation will spend the time to keep these updated.
We can barely keep public-facing API documentation up-to-date. Diagrams like this are an order of magnitude harder to keep up-to-date, and Solution Architects will refuse to go to this level of detail, as they'd actually have to think through the problem and do some actual system design.
But as a consultant, I'm going to use this in my kick-off projects and my proof-of-concepts, and it's going to dazzle everyone. But maybe 5% of my clients would pay me to do detailed diagrams or documentation like this.
As an employee however; nobody on my team, nor my projects, nor my wider organisation will spend the time to keep these updated.
We can barely keep public-facing API documentation up-to-date. Diagrams like this are an order of magnitude harder to keep up-to-date, and Solution Architects will refuse to go to this level of detail, as they'd actually have to think through the problem and do some actual system design.
But as a consultant, I'm going to use this in my kick-off projects and my proof-of-concepts, and it's going to dazzle everyone. But maybe 5% of my clients would pay me to do detailed diagrams or documentation like this.