update documentation and fix incorrect links