add some more docs + small fixes
bump version + make public