Update fail docs for new syntax

Use when instead of only_if
Use new variable style
Merge pull request #3480 from j2sol/fail_doc

Update fail docs for new syntax