Another approach is ADRs, which document alternatives considered, but these are documentation, not comments. I've found them useful for building consensus aroun

Another approach is ADRs, which document alternatives considered, but these are documentation, not comments. I've found them useful for building consensus around architecture decisions. https://adr.github.io/ https://adr.github.io/