All seems pretty reasonable except this: "Documentation must be unambiguous, really step-by-step, without assuming anything about what the dev should know alre

All seems pretty reasonable except this: "Documentation must be unambiguous, really step-by-step, without assuming anything about what the dev should know already" this will just about never happen. Documentation always lags. You have to be able to connect some dots sometimes.