requirements are not documentation
update docs
Merge pull request #48 from ccarruitero/somefixes

Some fixes