javadoc for Persist directory

Also cleanup & tighten the API