more documentation, API tweaks and updates