Feat/improve doc build logic

[moe-ad]

Description

This PR will close #501. Pre-build scripts are set up as hooks in conf.py and "sphinx-build ..." is being called directly in tox instead of "make ..."

Checklist

• I have tested these changes locally.
• I have added necessary documentation or updated existing documentation.
• I have linked the issue(s) addressed by this PR if any.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 92.45%. Comparing base (28fa37e) to head (fef5eb5).
Report is 2 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #502   +/-   ##
=======================================
  Coverage   92.45%   92.45%           
=======================================
  Files          64       64           
  Lines        2599     2599           
=======================================
  Hits         2403     2403           
  Misses        196      196           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[jorgepiloto]

Thanks, @moe-ad. Just left some minor comments.

[FedericoNegri]

why using all caps for variables like examples, source_dir etc?

[moe-ad]

This is because those more or less do not change, like constants.
If you prefer, I can move examples to the top of the file and pass it as an argument to the function instead.

[FedericoNegri]

SOURCE_DIR should just be a lower case variable, it depends on the input app, it's not a constant.
Regarding EXAMPLES, either you move it outside of the function as a constant or you make it lower case inside the function. Either is fine with me.

[moe-ad]

Thanks! Implemented your suggestions.