add doc page about retry-ability

[bahmutov]

done

• link to cypress-pipe and retrying clicks from blog post https://www.cypress.io/blog/2019/01/22/when-can-the-test-click/
• closes Document retry-ability #1278

items below will be done separately

I am thinking how to better address these, since they don't really fit into the example used through the page. It might take another separate PR

• explain how to implement retries in custom commands, use cypress-xpath as an example
• address example and question from https://github.com/cypress-io/cypress/issues/3184

Code example in https://github.com/cypress-io/cypress-example-todomvc/tree/doc-retry-ability

[lukeapage]

Would be worth mentioning cypress-pipe which allows you to write custom commands that have retry-ability?

[jennifer-shehane]

You want this reviewed now? I see some checkboxes not done, so I'm unsure.

[bahmutov]

@jennifer-shehane I think the unchecked boxes should be addressed in separate PRs. For example, adding retry-ability to the custom commands should be documented in the custom commands guide. so I would like to land this so I can create a section in the testing workshop based on this doc.

[jennifer-shehane]

Dependent on this: https://github.com/cypress-io/cypress-monorepo/issues/221

[bahmutov]

oh no @jennifer-shehane

1) Guides Table of Contents displays toc:
     CypressError: cy.request() failed on:

http://localhost:2222/guides/core-concepts/retry-ability.html

The response we received from your web server was:

  > 404: Not Found

This was considered a failure because the status code was not '2xx' or '3xx'.

If you do not want status codes to cause failures pass the option: 'failOnStatusCode: false'

-----------------------------------------------------------

The request we sent was:

Method: GET
URL: http://localhost:2222/guides/core-concepts/retry-ability.html
Headers: {
  "user-agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Cypress/3.1.5 Chrome/59.0.3071.115 Electron/1.8.2 Safari/537.36",
  "accept": "*/*",
  "accept-encoding": "gzip, deflate"
}

[jennifer-shehane]

oh, duh, I forgot to move the actual file 🙄 Will fix now

[bahmutov]

Relevant testing workshop section https://gitpitch.com/cypress-io/testing-workshop-cypress?p=slides/11-retry-ability

[jennifer-shehane]

The cypress.on link was pushed