* commit 'b190890a94dc2f0bd11da09f59550f86197f010a': Update javadoc to give app write better guidence