Also, too much information is just as bad as not enough. I’ve seen many a project whose home page or README dives straight into technical jargon about it, telli

Also, too much information is just as bad as not enough. I’ve seen many a project whose home page or README dives straight into technical jargon about it, telling me all about how it’s world-changing and completely unlike anything else, without explaining in one clear sentence what the thing is and why I might want to use it. You’ve got to hold my hand if you want to take me through a paradigm shift, or I’m going to assume your software is a Rube Goldberg contraption that doesn’t really do anything.