You're right that many github-hosted projects suffer from overly-brief documentation. Perhaps Github attracts a certain type of project maintainer at the moment..