(maint) add documentation for --fail-mode