docs(api) Small improvements to the documentation generator

docs(api) Small improvements to the documentation generator

Added support for link annotations
Added documentation for by.addLocator
Added a few @alias text to make it more readable