Generate docs from README?

Would it be against Rust documentation best practices to not have the comment blocks at the top of the lib.rs files? Right now these are being used to generate the README.md files using maint/readmes.sh

Rust 1.54+ allows adding this at the top of a file instead of a comment block #![doc = include_str!("../README.md")]

Then the READMEs could be the only places that need updating.