Merge branch 'master' into master

assets/screenshot_guidelines.md

@@ -1,10 +1,10 @@
 ### The following is a list of direct links to sections that include a screenshot, animated gif, or video with associated code to recreate. Remember that the viewport will need to be zoomed, probably beyond what you'd expect, so that the areas of interest are visible when sized down to the main content well. In most cases below the viewport was at 150%. 
 
-### The best workflow for high quailty/small output so far is to capture via quicktime -> trim accordingly -> convert file via https://gif.ski @960xXXX | speed at 1 notch | 20FPS | maxed out quality | loop forever (or comprable using the gifski CLI). 
+### The best workflow for high quality/small output so far is to capture via quicktime -> trim accordingly -> convert file via https://gif.ski @960xXXX | speed at 1 notch | 20FPS | maxed out quality | loop forever (or comparable using the gifski CLI). 
 
 # Cypress App v10 UI (no specific application)
 
-http://localhost:3000/guides/getting-started/writing-your-first-end-to-end-test#Write-your-first-test
+http://localhost:3000/guides/end-to-end-testing/writing-your-first-end-to-end-test#Write-your-first-test
 ```js
 describe('My First Test', () => {
   it('Does not do much!', () => {
@@ -19,7 +19,7 @@ describe('My First Test', () => {
 })
 ```
 
-http://localhost:3000/guides/getting-started/writing-your-first-end-to-end-test#Step-2-Query-for-an-element
+http://localhost:3000/guides/end-to-end-testing/writing-your-first-end-to-end-test#Step-2-Query-for-an-element
 ```js
 describe('My First Test', () => {
   it('finds the content "type"', () => {
@@ -30,7 +30,7 @@ describe('My First Test', () => {
 })
 ```
 
-http://localhost:3000/guides/getting-started/testing-your-app#Step-2-Visit-your-server
+http://localhost:3000/guides/end-to-end-testing/testing-your-app#Step-2-Visit-your-server
 1) touch cypress/e2e/home_page.cy.js -> capture full app UI with spec
 ```js
 describe('The Home Page', () => {
@@ -562,7 +562,7 @@ describe('Assertions', () => {
 ```
 
 http://localhost:3000/guides/core-concepts/retry-ability#Correctly-waiting-for-values (gif)
-1) Run the last test in [this spec](https://github.com/cypress-io/cypress-example-kitchensink/blob/master/cypress/integration/2-advanced-examples/assertions.spec.js)
+1) Run the last test in [this spec](https://github.com/cypress-io/cypress-example-kitchensink/blob/master/cypress/e2e/2-advanced-examples/assertions.cy.js)
 2) Hide the surrounding html to isolate the random counter & bump up font-size in-line to make visible in example
 ```js
 cy.get('#random-number').should(($div) => {
@@ -639,7 +639,7 @@ describe('TodoMVC - React', function () {
 
 http://localhost:3000/guides/core-concepts/cypress-app#What-you-ll-learn
 1) Hero image of Cypress GUI
-Load [this test](https://github.com/cypress-io/cypress-example-todomvc/blob/724757df744c499a3596ca45c2c57da3aad371a5/cypress/integration/app_spec.js#L89) 
+Load [this test](https://github.com/cypress-io/cypress-example-todomvc/blob/master/cypress/e2e/app.cy.js#L89) 
 
 http://localhost:3000/guides/core-concepts/cypress-app#Finding-Selectors (gif)
 ```html

content/_changelogs/0.11.1.md

@@ -4,7 +4,7 @@ _Released 09/14/2015_
 
 **Bugfixes:**
 
-- Utilizing [`cy.server()`](/api/commands/server) across multiple tests before a
+- Utilizing `cy.server()` across multiple tests before a
   [`cy.visit()`](/api/commands/visit) now works correctly. As a side effect now
   Cypress will rebind both the `server` and all `routes` **whenever** the remote
   window is reloaded (for whatever reason) - even during a test itself. This

content/_changelogs/0.12.0.md

@@ -37,7 +37,7 @@ _Released 10/23/2015_
   words they will _really_ go out and you'll be able to inspect them just like
   regular XHRs.
 - Regular XHR's can now be aliased and waited on without actually being stubbed
-  by passing `{stub: false}` to the [`cy.route()`](/api/commands/route).
+  by passing `{stub: false}` to the `cy.route()`.
 - XHR's will continue to work correctly even _after_ a test ends. In previous
   versions, due to replacing the entire XHR object, your application would not
   work correctly after a test ended. This prevented you from "navigating around"
@@ -73,16 +73,15 @@ _Released 10/23/2015_
 
 **Bugfixes:**
 
-- Routes no longer display as duplicated in between test runs when
-  [`cy.server()`](/api/commands/server) is started prior to a
-  [`cy.visit()`](/api/commands/visit) and you cause a full page refresh, which
-  caused all routes to be re-bound.
+- Routes no longer display as duplicated in between test runs when `cy.server()`
+  is started prior to a [`cy.visit()`](/api/commands/visit) and you cause a full
+  page refresh, which caused all routes to be re-bound.
 - Any issues related to `requestJSON` or `responseJSON` being duplicated are now
   fixed. Fixes [#65](https://github.com/cypress-io/cypress/issues/65).
 - Fully Qualified XHR's which should be proxied are now correctly transparently
   rewritten to prevent CORS problems.
-- [`cy.route()`](/api/commands/route) - `onRequest` and `onResponse` callbacks
-  are now called with `cy` as the context.
+- `cy.route()` - `onRequest` and `onResponse` callbacks are now called with `cy`
+  as the context.
 - Filtering assets which should never be stubbed has been improved. Now `.jsx`
   templates pass-through correctly.
 - CORS Network Errors are now correctly caught.

content/_changelogs/0.12.1.md

@@ -4,10 +4,10 @@ _Released 10/28/2015_
 
 **Bugfixes:**
 
-- [`cy.route()`](/api/commands/route) will no longer throw that a response is
-  needed when using [`cy.server({stub: false})`](/api/commands/server).
-- Applying server defaults to `Cypress.Server.defaults({})` now
-  [works as documented](/api/cypress-api/cypress-server).
+- `cy.route()` will no longer throw that a response is needed when using
+  `cy.server({stub: false})`.
+- Applying server defaults to `Cypress.Server.defaults({})` now works as
+  documented.
 - `onRequest` and `onResponse` can now be correctly set as permanent server
   defaults.
 - XHR URL is now decoded to make assertions easier. Fixes

content/_changelogs/0.12.6.md

@@ -20,10 +20,9 @@ _Released 11/29/2015_
   which caused the error: `The XHR server is unavailable or missing...`. Fixes
   [#80](https://github.com/cypress-io/cypress/issues/80) and
   [#86](https://github.com/cypress-io/cypress/issues/86).
-- Prevent accidental mutation of [`cy.server()`](/api/commands/server) options
-  when [`cy.route()`](/api/commands/route) was provided options. Fixes
-  [#84](https://github.com/cypress-io/cypress/issues/84) and
-  [#85](https://github.com/cypress-io/cypress/issues/85).
+- Prevent accidental mutation of `cy.server()` options when `cy.route()` was
+  provided options. Fixes [#84](https://github.com/cypress-io/cypress/issues/84)
+  and [#85](https://github.com/cypress-io/cypress/issues/85).
 - Using [`cy.title()`](/api/commands/title) would incorrectly search the
   `<body>` for title elements, and is now restricted to only searching in the
   `<head>`

content/_changelogs/0.13.2.md

@@ -4,9 +4,8 @@ _Released 12/20/2015_
 
 **Notes:**
 
-- Docs have been updated for [`cy.wait()`](/api/commands/wait),
-  [`cy.route()`](/api/commands/route) and [`cy.server()`](/api/commands/server)
-  to reflect these changes.
+- Docs have been updated for [`cy.wait()`](/api/commands/wait), `cy.route()` and
+  `cy.server()` to reflect these changes.
 
 **Features:**
 
@@ -40,13 +39,12 @@ _Released 12/20/2015_
 
 **Misc:**
 
-- Removed `{stub: false}` option from [`cy.server()`](/api/commands/server) and
-  [`cy.route()`](/api/commands/route). Cypress will now log a deprecation
-  warning when you use the this option. Removing this option helps simplify the
-  API because now Cypress can figure out whether you really want to stub the
-  route based on whether you've provided a response or not. If you have not
-  provided a response, the default behavior will be to not stub. If you do
-  provide a response, Cypress will stub the route.
+- Removed `{stub: false}` option from `cy.server()` and `cy.route()`. Cypress
+  will now log a deprecation warning when you use the this option. Removing this
+  option helps simplify the API because now Cypress can figure out whether you
+  really want to stub the route based on whether you've provided a response or
+  not. If you have not provided a response, the default behavior will be to not
+  stub. If you do provide a response, Cypress will stub the route.
 - Repurposed `requestTimeout` to now mean the time we wait for an XHR to be
   requested. Changed [`cy.request()`](/api/commands/request) to now use
   `responseTimeout` configuration value.

content/_changelogs/0.13.3.md

@@ -53,6 +53,5 @@ _Released 12/25/2015_
 - Elements which are stringified during errors now indicate their text content
   (truncated to 10 characters) `<button>Save</button>` or whether they contain
   children elements by indicating an ellipsis `<div>...</div>`.
-- The [Routes instrument panel](/api/commands/route) now displays the column:
-  `Stubbed` instead of `Status`, which indicates whether a route is stubbing
-  matching XHR's.
+- The Routes instrument panel now displays the column: `Stubbed` instead of
+  `Status`, which indicates whether a route is stubbing matching XHR's.

content/_changelogs/0.13.4.md

@@ -33,8 +33,7 @@ _Released 12/31/2015_
 
 **Misc:**
 
-- The default behavior of [`cy.server()`](/api/commands/server) has changed from
-  `force404: true` to become `force404: false`. In other words, Cypress will no
-  longer forcibly send XHR's to 404 status when these XHR's do not match any
-  existing [`cy.route()`](/api/commands/route). This change better aligns with
-  predictable usage for most Cypress users.
+- The default behavior of `cy.server()` has changed from `force404: true` to
+  become `force404: false`. In other words, Cypress will no longer forcibly send
+  XHR's to 404 status when these XHR's do not match any existing `cy.route()`.
+  This change better aligns with predictable usage for most Cypress users.

content/_changelogs/0.13.6.md

@@ -7,8 +7,8 @@ _Released 01/09/2016_
 - All commands now retry if the associated element is disabled until the element
   is no longer disabled. If the command times out a specific error message is
   now thrown.
-- [`cy.server()`](/api/commands/server) and [`cy.route()`](/api/commands/route)
-  now take an optional `onAbort` callback which fires anytime an XHR is aborted.
+- `cy.server()` and `cy.route()` now take an optional `onAbort` callback which
+  fires anytime an XHR is aborted.
 
 **Bugfixes:**
 

content/_changelogs/0.16.2.md

@@ -24,9 +24,9 @@ _Released 06/11/2016_
 - Added new [`.each()`](/api/commands/each) command which iterates serially on a
   collection yielding the iteratee, the index, and the collection. Addresses
   [#156](https://github.com/cypress-io/cypress/issues/156).
-- [`cy.route()`](/api/commands/route) can now accept a single function and/or
-  you can pass a function to the `response` property. This allows you to lazily
-  evaluate routing responses. Great for referencing fixtures. Addresses
+- `cy.route()` can now accept a single function and/or you can pass a function
+  to the `response` property. This allows you to lazily evaluate routing
+  responses. Great for referencing fixtures. Addresses
   [#152](https://github.com/cypress-io/cypress/issues/152).
 - [`cy.contains()`](/api/commands/contains) now accepts a regular expression.
   Addresses [#158](https://github.com/cypress-io/cypress/issues/158).

content/_changelogs/0.16.3.md

@@ -4,7 +4,7 @@ _Released 06/17/2016_
 
 **Features:**
 
-- [`cy.route()`](/api/commands/route) now accepts string glob patterns using
+- `cy.route()` now accepts string glob patterns using
   [minimatch](https://github.com/isaacs/minimatch) under the hood. This means
   you can more easily route dynamic urls without using `regex`. Example:
   `cy.route('POST', '/users/*/comments', {})`.
@@ -43,9 +43,8 @@ _Released 06/17/2016_
 
 **Misc:**
 
-- [`Cypress.Server.defaults()`](/api/cypress-api/cypress-server) now accepts a
-  `urlMatchingOptions` option for passing options to
-  [minimatch](https://github.com/isaacs/minimatch).
+- `Cypress.Server.defaults()` now accepts a `urlMatchingOptions` option for
+  passing options to [minimatch](https://github.com/isaacs/minimatch).
 - [cypress run](/guides/guides/command-line#cypress-run) now exits with the
   number of test failures instead of always exiting with 0. This matches the
   same way `cypress ci` works. Fixes

content/_changelogs/0.18.5.md

@@ -22,6 +22,5 @@ _Released 01/08/2017_
 - Enable [`cy.fixture()`](/api/commands/fixture) to send an encoding for images
   other than forcing the default encoding of `base64`. Fixes
   [#373](https://github.com/cypress-io/cypress/issues/373).
-- Enable [`cy.route()`](/api/commands/route) to pass an `encoding` parameter
-  when using `fx:fixture` syntax. Fixes
-  [#374](https://github.com/cypress-io/cypress/issues/374).
+- Enable `cy.route()` to pass an `encoding` parameter when using `fx:fixture`
+  syntax. Fixes [#374](https://github.com/cypress-io/cypress/issues/374).

content/_changelogs/0.19.0.md

@@ -8,7 +8,7 @@ _Released 02/11/2017_
   [CI Docs](/guides/continuous-integration/introduction) got a much needed
   facelift.
 - There is a new docs section related to the
-  [Dashboard](/guides/dashboard/introduction) and the new features.
+  [Dashboard](/guides/cloud/introduction) and the new features.
 
 **Overview:**
 

content/_changelogs/0.20.0.md

@@ -195,12 +195,12 @@ _Released 09/10/2017_
 
 - Updated [Cypress.Promise](/api/utilities/promise) (which is Bluebird) from
   version `2.9.25` to `3.5.0`
-- Updated [chai](/guides/references/bundled-tools#Chai) from version `1.9.2` to
-  `3.5.0`
-- Updated [sinon](/guides/references/bundled-tools#Sinon) from version `1.x` to
-  `3.2.0`
+- Updated [chai](/guides/references/bundled-libraries#Chai) from version `1.9.2`
+  to `3.5.0`
+- Updated [sinon](/guides/references/bundled-libraries#Sinon-JS) from version
+  `1.x` to `3.2.0`
 - Updated [jQuery](/api/utilities/$) from version `2.1.4` to `2.2.4`.
-- Removed [chai-jQuery](/guides/references/bundled-tools#Chai-jQuery) and
+- Removed [chai-jQuery](/guides/references/bundled-libraries#Chai-jQuery) and
   rewrote it from scratch.
 
 **Deprecations:**
@@ -222,10 +222,10 @@ _Released 09/10/2017_
 - Fixed busted internal timers that caused random timeouts, proxy errors,
   incorrect delays, and long pauses when loading the GUI. Fixes
   [#572](https://github.com/cypress-io/cypress/issues/572).
-- [cy.route()](/api/commands/route) now matches requests opened with lowercase
-  methods. Fixes [#607](https://github.com/cypress-io/cypress/issues/607).
-- Fixed regression where multiple uses of [`cy.server()`](/api/commands/server)
-  in a `before` hook was throwing an error. Fixes
+- `cy.route()` now matches requests opened with lowercase methods. Fixes
+  [#607](https://github.com/cypress-io/cypress/issues/607).
+- Fixed regression where multiple uses of `cy.server()` in a `before` hook was
+  throwing an error. Fixes
   [#80](https://github.com/cypress-io/cypress/issues/80) and
   [#510](https://github.com/cypress-io/cypress/issues/510) and
   [#595](https://github.com/cypress-io/cypress/issues/595).
@@ -399,8 +399,8 @@ Note: we are still updating all of the docs to reflect all the 0.20.0 changes.
 - [New "cy.scrollTo()"](/api/commands/scrollto)
 - [New ".scrollIntoView()"](/api/commands/scrollintoview)
 - [Updated "Installing Cypress"](/guides/getting-started/installing-cypress)
-- [Updated "Writing Your First Test"](/guides/getting-started/writing-your-first-test)
-- [Updated "Testing Your App"](/guides/getting-started/testing-your-app)
+- [Updated "Writing Your First Test"](/guides/end-to-end-testing/writing-your-first-end-to-end-test)
+- [Updated "Testing Your App"](/guides/end-to-end-testing/testing-your-app)
 - [Updated "Command Line"](/guides/guides/command-line)
 - [Updated "Debugging"](/guides/guides/debugging)
 - [Updated "Assertions"](/guides/references/assertions)

content/_changelogs/0.3.3.md

@@ -5,13 +5,11 @@ _Released 03/18/2015_
 **Features:**
 
 - Filtered out Ajax requests for `.js`, `.html`, `.css` files by default.
-- [`cy.server()`](/api/commands/server) can configure whether this is turned on
-  or off.
+- `cy.server()` can configure whether this is turned on or off.
 
 **Bugfixes:**
 
-- Prevent [`cy.server()`](/api/commands/server) from slurping up Angular async
-  template GETs.
+- Prevent `cy.server()` from slurping up Angular async template GETs.
 
 **Misc:**
 

content/_changelogs/0.4.3.md

@@ -4,11 +4,10 @@ _Released 04/09/2015_
 
 **Features:**
 
-- Added functionality which enables [`cy.server()`](/api/commands/server) and
-  [`cy.route()`](/api/commands/route) to be created prior to
-  [`cy.visit()`](/api/commands/visit). The server and routes will apply to the
-  next page which is visited. This allows you to stub requests which happen on
-  page load. Suggested in
+- Added functionality which enables `cy.server()` and `cy.route()` to be created
+  prior to [`cy.visit()`](/api/commands/visit). The server and routes will apply
+  to the next page which is visited. This allows you to stub requests which
+  happen on page load. Suggested in
   [#17](https://github.com/cypress-io/cypress/issues/17).
 - [`cy.visit()`](/api/commands/visit) now takes an optional `onBeforeLoad`
   callback option which is invoked when your page begins to ender but prior to

content/_changelogs/0.4.4.md

@@ -12,5 +12,5 @@ _Released 04/09/2015_
 - Improved error messages for traversal failures. Errors now include the parent
   context DOM element. Fixes
   [#11](https://github.com/cypress-io/cypress/issues/11).
-- Improved error messages for invalid [`cy.route()`](/api/commands/route)
-  arguments. Fixes [#20](https://github.com/cypress-io/cypress/issues/20).
+- Improved error messages for invalid `cy.route()` arguments. Fixes
+  [#20](https://github.com/cypress-io/cypress/issues/20).

content/_changelogs/0.5.10.md

@@ -4,15 +4,14 @@ _Released 04/28/2015_
 
 **Features:**
 
-- [`cy.server()`](/api/commands/server) now accepts a `delay` option which will
-  delay all responses to requests (including 404) based on the value in ms
-- [`cy.server()`](/api/commands/server) now accepts a `respond` option which can
-  turn off automatic responding to requests.
-- [`cy.route()`](/api/commands/route) now accepts a `delay` option which
-  overrides the delay option set in [`cy.server()`](/api/commands/server) to
-  just matched requests.
-- [`cy.route()`](/api/commands/route) now accepts a `respond` option which will
-  turn off automatic responding to just matched requests.
+- `cy.server()` now accepts a `delay` option which will delay all responses to
+  requests (including 404) based on the value in ms
+- `cy.server()` now accepts a `respond` option which can turn off automatic
+  responding to requests.
+- `cy.route()` now accepts a `delay` option which overrides the delay option set
+  in `cy.server()` to just matched requests.
+- `cy.route()` now accepts a `respond` option which will turn off automatic
+  responding to just matched requests.
 - Fixes [#14](https://github.com/cypress-io/cypress/issues/14).
 - [`cy.wait()`](/api/commands/wait) now accepts an alias property called
   `request`. Example: `cy.wait('@getUsers.request')` which ill resolve once the

content/_changelogs/0.7.0.md

@@ -14,9 +14,9 @@ _Released 06/15/2015_
 - Fixtures are automatically formatted / indented for easy debugging.
 - Example fixture is automatically created with every project.
 - Example support files are now automatically created with every project.
-- [`cy.route()`](/api/commands/route) now accepts an **alias** as its response.
-- [`cy.route()`](/api/commands/route) additionally accepts a special `fixture:`
-  or `fx:` keyword which automatically loads the fixture as the response.
+- `cy.route()` now accepts an **alias** as its response.
+- `cy.route()` additionally accepts a special `fixture:` or `fx:` keyword which
+  automatically loads the fixture as the response.
 
 **Bugfixes:**
 

content/_changelogs/0.7.4.md

@@ -8,7 +8,7 @@ _Released 06/18/2015_
   throw an error. The error guides you to using the
   [`.select()`](/api/commands/select) command, as that is the command you should
   use to change a `<select>` value.
-- [`cy.route()`](/api/commands/route) responses are now validated. If responses
-  are `null` or `undefined` Cypress will throw a very specific error message.
+- `cy.route()` responses are now validated. If responses are `null` or
+  `undefined` Cypress will throw a very specific error message.
 - Cypress will now display `cypress.json` parse errors when attempting to boot a
   project when there is a syntax error in `cypress.json`.