On 09/07/2019 14.02, Julien Palard wrote:
Hi Christian,
the table with auditing events does not render on docs.python.org, https://docs.python.org/3.9/library/audit_events.html. Steve and I are going to present the auditing feature tomorrow at EuroPython. It would be helpful to have the table available.
This was not an easy one... and it may be a Sphinx issue, yet I'm still not sure, maybe Steve can shed some light on it:
It's the "-j" option of sphinx-build (to parallelize) that causes the issue. I double checked it (full commands at the end of the message in case someone want to reproduce it):
- Run with -j4 → No table - Run without -j → Table is here - Run again with -j4 → No table! - Run again without -j → Table is back!
I'm patching docsbuild-scripts to stop using -j4 with is not really helpfull anyway as docsbuild script is parallelizing by starting multiple sphinx-build (for multiple languages / versions).
I also copied the file and invalidated the cache, so https://docs.python.org/3.9/library/audit_events.html is good again.
If I'm too slow testing locally and releasing a new docsbuild_script.py, the cron MAY break the file again, don't hesitate to poke me if it happen without me noticing first.
Fantastic! It'll do for now. Thank you! I'll follow up with you after EuroPython. Christian