“Show me your flowcharts (source code), and conceal your tables (domain model), and I shall continue to be mystified; show me your tables (domain model) and I won’t usually need your flowcharts (source code): they’ll be obvious.”
~ Fred Brooks, “The Mythical Man Month”
Stuff that has improved or the potential to improve the documentability of modern systems, imo:
postgREST,
custom types (e.g. domains in postgresql),
more expressive type systems e.g. rust, haskell, typescript perhaps (though I am not completely sold on typescript yet myself)
nix/nixos (or more mainstream, hashicorp products/ansible/puppet/docker)
kubernetes and co. (most people probably don't need)
~ Fred Brooks, “The Mythical Man Month”
Stuff that has improved or the potential to improve the documentability of modern systems, imo: postgREST, custom types (e.g. domains in postgresql), more expressive type systems e.g. rust, haskell, typescript perhaps (though I am not completely sold on typescript yet myself) nix/nixos (or more mainstream, hashicorp products/ansible/puppet/docker) kubernetes and co. (most people probably don't need)