revert to old style javadoc link

fixed doc typos, more tweaks in the post layout