Crates.io does a pretty good job of this with their docs folder and I think that it'd be really worth it to put down the hows and whys of docs.rs so that incoming contributors can get a jump start in understanding the codebase