Publish the wiki: Home, Usage, Troubleshooting, Release history Four pages, aimed at somebody who has just found the repository. Home says what the tool is and lists the five things this format gets wrong that a newcomer would not guess. Usage walks the whole pipeline command by command. Troubleshooting pairs each symptom with its real cause. Release history says, per release, what it is safe to be trusted for -- including where it is not. The pages that change with the code stay in the repository and are linked from here rather than copied.
Initial Home page