The documentation is under way, meanwhile watch this talk from JSConf Budapest. The talk gives a thorough introduction of the concept of semantic-release.