Ready for beta release?

doc updates, library review