Get the README complexity score for a Github repo:
40 out of 40 | Number of code blocks |
10 out of 30 | Penalty for few code blocks (all or nothing) |
ScoreMe gives you a numerical score from 0 to 100 for your Github-style README. The intention is to measure complexity, which is a generally correlated with quality.
It won't measure if one README is absolutely better than another, but it will give you a good idea if the README is high-quality, needs more work, or somewhere inbetween.
You can use this website, the HTTP API, or the Ruby library to calculate scores. Only the HTTP API and SVG badges will return cached scores unless configured otherwise.
Some projects like rails/rails have most of their documentation outside of the README. In those cases, the score doesn't mean a whole lot if you're using it alone to interpret quality.
If you feel like the calculation should be tweaked, then definitely open an issue with your expected and actual results.
CocoaPods/CocoaDocs needed to calculate README complexity, and @clayallsopp thought that sounded fun, so here we are. This delightful little website was designed by Tiffany Young.