make version easily propagate to docs
reorder api docs

fix factories docs
intro text for docs
Merge pull request #28 from fizyk/docs-fixes

Docs fixes