removed `@link` tags from apidoc and replaced with markdown