more documentation and api changes