Documentation: add a section to prevent spurious test failures like the one