minor optimization of how the href is constructed
JavaDoc updates, minor code update for readability