A widely referenced post at dguo.github.io/blog/how-to-make-a-readme that covers the elements of an effective README with concrete examples. Short enough to read in one sitting.