I disagree, schematics are a form of documentation. They are not a design and they are incredibly leaky. As an example, it's common to group all the bypass cap

I disagree, schematics are a form of documentation. They are not a design and they are incredibly leaky. As an example, it's common to group all the bypass caps together in a schematic. This doesn't reflect the reality that those bypass caps need to be physically close to the power pins on specific components. The value is not sufficient to reflect their use. It's no different from software engineering, the schematic is not the source code. It's a block diagram describing how the source works.