I’ve just discovered that docs.rs displays a crate’s GitHub README. Can you tell the difference between these two pages:
I was quite confused, and I think all this redundant information makes a poor experience.
In any case, we have no guidelines for crate READMEs, and since this is a crucial part of the documentation UI, it seems like we must establish some, then go back and review the crates we’ve done. cc @dtolnay