feat: add documentation build environment to tox.ini

[moe-ad]

As the title states. This closes #2011.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 88.45%. Comparing base (c95bb99) to head (238d405).
Report is 1 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #2015      +/-   ##
==========================================
- Coverage   88.50%   88.45%   -0.06%     
==========================================
  Files          90       90              
  Lines       10269    10269              
==========================================
- Hits         9089     9083       -6     
- Misses       1180     1186       +6     

[jorgepiloto]

Suggesting to implement a clean and links environment.

[jorgepiloto]

Awesome, @moe-ad. Would it be possible to have the commands_post at [testenv] level? That would apply it for every environment, right?

[moe-ad]

@jorgepiloto Yes, indeed, that is possible at the [testenv] level. It will affect all environments and in environments where the commands are not needed, we can override command_pre/post to do nothing in those.

One problem is when you want to run some environments in parallel, the nature of what we are doing in commands_pre/post for PyDPF means that environments that finish executing earlier will try to kill the processes of currently running environments.

Another problem even in a sequential run is this:

• This workflow is not possible: commands_pre -> test_a -> test_b -> commands_post
• What will instead happen is: commands_pre -> test_a -> commands_post -> commands_pre -> test_b -> commands_post

And the first workflow is desired in the case of PyDPF.

[jorgepiloto]

Thanks for the detailed explanation, @moe-ad. Then, feel free to merge when ready.