add and update docs and links