be nitpicky about missing references

This adds the `-n` flag when building the docs to prevent broken links.

For some reason this reported errors about some Python modules in pybind missing, so it also adds the pybind path if it is not already there.

Having that check in sys.path got rid of the errors making the gitbuilder yellow again (warnings unrelated to this change)