complete documentation and fix links