Add enhanced pydoc-markdown pre-hook

[masci]

Related Issues

• No issue, just the pre-commit hook was too slow

Proposed Changes:

Instead of building all the docs at every commit to ensure docs were updated, this pre-hook script will only try to build the API docs corresponding to the files actually changed, and skip the build altogether if the changed files aren't relevant for a documentation change.

How did you test it?

Just check out my branch, try changing a documented API and run pre-commit or try to actual make the commit.

Notes for the reviewer

This check makes several assumptions:

• The source of truth about whether or not we should build docs is the search_path field inside the pydoc config files
• For each pydoc config file, there is always one and only one entry in the search_path array

Checklist

• I have read the contributors guidelines and the code of conduct
• I have updated the related issue with new insights and changes
• I added tests that demonstrate the correct behavior of the change
• I've used the conventional commit convention for my PR title
• I documented my code
• I ran pre-commit hooks and fixed any issue

[vblagoje]

Tested on linux ubuntu, I assumed @masci tested it on OSX. It worked ok for the random tests I tried. Approved