Readability and README Writing

Two jobs. The common one: measure and improve reading level in any prose — a doc, an email, a proposal, a spec, a plan. The narrower one: structure a README.

Always Measure — Never Estimate

Syllable counts cannot be eyeballed accurately across a document. Reporting a Flesch-Kincaid score without running the script is guessing. Run it.

cat FILE | ruby scripts/flesch_kincaid.rb

Works on any text, not just markdown — pipe in an email draft, a section of a doc, a paragraph pasted into a heredoc.