[FLINK-1172] Fix broken links in documentation

i need someone to check the actual .html files produced since i can't get the build_docs.sh script to run properly, one cryptic error message after the next...