improve doc generator resilience