add javadoc
fix javadoc link
new samples