make the links in  actually work
fix more docstrings