javadoc clarifications, add some ideas for future work
add yaml jackson test, and more quickstart simplification