It would be recommended to have a common template for README files including:

• Truebit banner
• Project Badges (code quality, gitter, travis, ...)
• Table of Contents
• High Level description
• Get Started
• Details
• License

This one could be used as reference: https://github.com/oceanprotocol/keeper-contracts/