Giter Site home page Giter Site logo

cypress-io / cypress-documentation Goto Github PK

View Code? Open in Web Editor NEW
903.0 903.0 1.0K 736.4 MB

Cypress Documentation including Guides, API, Plugins, Examples, & FAQ.

Home Page: https://docs.cypress.io

License: MIT License

JavaScript 29.99% Shell 0.88% CSS 3.22% TypeScript 45.39% SCSS 20.52%
api cypress documentation examples faq guides plugins

cypress-documentation's Introduction

Cypress Documentation Discord chat first-timers-only

The code for Cypress Documentation including Guides, API, Examples, Cypress Cloud & FAQ found at https://docs.cypress.io.

Cypress Documentation Preview

CI status

CircleCI main branch

Netlify Status

Our docs are built using Docusaurus.

Installation

$ npm i

Local Development

$ npm run start

This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.

Build

$ npm run build

This command generates static content into the dist directory and can be served using any static contents hosting service.

Contributing

Refer to the CONTRIBUTING.md guide for details.

License

This project is licensed under the terms of the MIT license.

cypress-documentation's People

Contributors

admah avatar amirrustam avatar atofstryker avatar avanslaars avatar bahmutov avatar bencodezen avatar brian-mann avatar chrisbreiding avatar conversayshawn avatar cowboy avatar debrisapron avatar elylucas avatar emilyrohrbough avatar flotwig avatar greenkeeper[bot] avatar icelemon1314 avatar jaffrepaul avatar jennifer-shehane avatar jessicasachs avatar jordanpowell88 avatar jun-jing avatar matthamil avatar mccataldo avatar mergify[bot] avatar mikemcc399 avatar randallkent avatar renovate[bot] avatar richdouglasevans avatar robertguss avatar valeriethoma avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

cypress-documentation's Issues

Update docs for 0.16.0 changes

  • Remove commands Cypress.Cookies.get(), Cypress.Cookies.set(), Cypress.Cookies.remove().
  • Add new pages for commands: cy.getCookie(), cy.clearCookie(), cy.setCookie().
  • Update cy.getCookies() and cy.clearCookies() commands with new returns.
  • Fix wording of cookies before from "remove" to "clear".
  • Fix wording of cypress clearing cookies to consistently state we clear cookies "before" each test.
  • Update install & running Cypress to new Browser extension workflow.
  • Write doc about Cypress & the Browser (how we manage sessions, the use of our extension, etc).

menuspy not working precisely

@lorennorman commented on Fri May 26 2017

I've noticed a few things weird about menuspy:

  • click a link on the right, page jumps to the right place, but the incorrect link is highlighted on the right
  • sometimes the highlighted link on the right does not match the anchor tag in the URL

Example:
cypress io documentation - error messages 2017-05-26 11-55-15


@jennifer-shehane commented on Thu Jul 06 2017

This issue was difficult to track down. Sometimes menuspy was accurate and sometimes not.

After some use, it seems to be most off when images are included on the page, so we suspect that menuspy is not properly calculating the height of images into it's scrolling algorithm. This is likely because the images have not loaded yet.

Can we calculate after the onload event? Does the onload event call before all images are loaded? Each image fires it's own load event, so you could check all images load event.

To test this, throttle the network in devtools.

Ongoing: Add new articles to examples

There are some pieces of material others have created in the community that mention Cypress. ๐ŸŽ‰

We would love to include these in our Media. Please take note of the categories we have in terms of media: Blogs, Screencasts, Talks, and Podcasts and make sure to place it in the correct category. When in doubt, just ask!

There are instructions on how to add new links here: https://github.com/cypress-io/cypress-documentation/blob/develop/CONTRIBUTING.md#adding-examples

Check off any links from the list after adding it to the examples. Reference the PR to this issue #315.

Links to material mentioning Cypress:

Internal spreadsheet of links: https://app.smartsheet.com/sheets/v5255vR5vCGj46gxgRxhxmXc2QX98jJhrH389Jg1?view=grid

have docs in `develop` branch automatically deploy to docs-staging.cypress.io

@jennifer-shehane commented on Wed Aug 23 2017

I'd like the same process for deployment as we have on master, where the docs are automatically deploy if docs directory was touched and the docs tests pass, except for deployment to go to docs-staging.cypress.io url when develop branch changes are made to docs.

And make sure docs scraping is not done in develop deployment.


@jennifer-shehane commented on Mon Aug 28 2017

Some of the resources don't appear to be loading correctly in docs-staging. I'd have to look at it more closely, but my first thought is that this url is incorrect in the hexo config when in staging, but I'd have to investigate more.

https://github.com/cypress-io/cypress-monorepo/blob/develop/docs/_config.yml#L14


@bahmutov commented on Mon Aug 28 2017

good observation, it might be broken then, I will look how we can overwrite it during build.
Can we actually test for this @jennifer-shehane ? I would love to run the e2e tests against deployed docs after deploy to catch this.


@bahmutov commented on Mon Aug 28 2017

The following JS files from theme/cypress are not copied into the public folder during build, breaking the finished website

screen shot 2017-08-28 at 1 59 55 pm


@bahmutov commented on Mon Aug 28 2017

ok, bundling JS for staging, but one page has problems - /guides/core-concepts/introduction-to-cypress.html - it is missing navigation asides

screen shot 2017-08-28 at 3 20 06 pm

How is it possible? Every other page in the guides is working

screen shot 2017-08-28 at 3 19 58 pm


@jennifer-shehane commented on Mon Aug 28 2017

The docs-staging site actually looks fine to me, is this only happening locally now?

Reroute direct links

@jennifer-shehane commented on Thu Jun 29 2017

Some outside resources have direct links to our docs. In particular, Frontend Masters links to this directly:

https://docs.cypress.io/docs/installing-and-running#section-direct-download

With the new docs structure, this really needs to route to /guides/getting-started/installing-cypress


@brian-mann commented on Thu Jun 29 2017

  • One option is to generate the redirect via the hexo plugin
  • Another option is to generate the redirect using s3 rules

@bahmutov commented on Wed Jul 05 2017

also include #263


@RandallKent commented on Fri Jul 07 2017

Tracking Document for Google Crawl Errors

Fix failing docs tests in branch "0.20 new content"

https://dashboard.cypress.io/#/projects/ma3dkn/runs/ab2991b5-2fb5-4d10-b92d-58dd70ba6209/failures

"API > Pagination > displays Next link"

CypressError: Timed out retrying: expected '/api/events/catalog-of-events.html' to include 'and.html'
at Object.cypressErr (http://localhost:2222/__cypress/static/js/cypress.js:5729:15)

"API > Pagination > click on Next page > should display Prev link"

Uncaught TypeError: Cannot read property 'map' of undefined

Because this error occured during a 'before each' hook we are skipping the remaining tests in the current suite: 'click on Next page'
at MenuSpy.cacheItems (http://localhost:2222/js/vendor/menuspy.js:114:36)

Things not rendering properly locally

This seems to only be happening locally when running npm start, but still - would like to preview the page I'm writing while writing it:

This markdown is rendering weird:

Markdown

`/home/<user>/.cypress/Cypress`

Preview
screen shot 2017-09-07 at 10 35 49 am

This sidebar is wrong too:

Preview
screen shot 2017-09-07 at 11 24 31 am

<html><body> inserted from some tags

for example this Markdown generates mini HTML fragment

# {% fa fa-graduation-cap %} What You'll Learn
<html><head><link rel="stylesheet" href="/css/prism-coy.396a03f0.css" type="text/css"></head><body><h1 id="What-Youโ€™ll-Learn" class="article-heading"><a href="#What-Youโ€™ll-Learn" class="headerlink" title=" What Youโ€™ll Learn"></a><i class="fa fa-graduation-cap"></i> What Youโ€™ll Learn<a class="article-anchor" href="#What-Youโ€™ll-Learn" aria-hidden="true"></a></h1>

The above markup by having <html>... inside of main body breaks parsing and escaping after it.

CSS broken in docs-staging

This commit seems to have broken the css in the https://docs-staging.cypress.io page. 5be5de4

See the Cypress Test Video of the run, where the css is obviously not loading correctly: https://dashboard.cypress.io/#/projects/ma3dkn/runs/c28f9d36-1eef-4bcf-b4fb-8e9a4732ac4f/videos

And the Cypress Test Video on the commit before, where the css is fine: https://dashboard.cypress.io/#/projects/ma3dkn/runs/480835eb-3b6b-490d-a7c7-259a1275820c/videos

We need to:

  1. Fix the bug
  2. Write a test that ensures css is compiling and loading correctly after the deployment job on CI.

Can recreate locally running NODE_ENV=staging npm start. Ensure you are on Node 8 and have run npm i first.

new content required for 0.20.0

@jennifer-shehane commented on Tue Sep 05 2017

Split out Cypress Utilities from Cypress Public API

The public methods available on Cypress have expanded beyond a point where it can be an afterthought on the API page. Specifically, we are talking about methods that are:

  1. Used by Cypress itself to write it's public API.
  2. Would be useful to users if they wanted to extend Cypress and/or write their own custom commands.

I am proposing separating these methods into their own main navigation called something like, "Utilities" / "API Utilities" (I'm very much open to more name suggestions). This will be an area where writing Cypress custom commands will be more elegantly addressed and also serve as a good reference for contributors to Cypress once we are open source.

A first draft of the Utilities sidebar:

  • Overview
    • About
    • Writing Custom Commands
  • Cypress.Commands
    • add
    • overwrite
  • Cypress.dom
    • getElements
    • getFirstFixedOrStickyPositionParent
    • getFirstScrollableParent
    • getReasonIsHidden
    • isDescendent
    • isDetached
    • isDocument
    • isDom
    • isElement
    • isHidden
    • isJquery
    • isScrollable
    • isSelector
    • isTextLike
    • isType
    • isVisible
    • isWindow
    • positionProps
    • stringify
    • unwrap
    • wrap
  • Cypress.log <- whoops, this should have a nested file...
  • need to call this something (these are all on cy because they are all stateful - and can only be issued during a running test - also all of these are functions)
    • addAlias
    • aliasNotFoundFor
    • clearTimeout
    • ensureAttached
    • ensureDescendents
    • ensureDocument
    • ensureElement
    • ensureElementIsNotAnimating
    • ensureElExistence
    • ensureExistence
    • ensureReceivability
    • ensureScrollability
    • ensureValidPosition
    • ensureVisibility
    • ensureWindow
    • getAbsoluteCoordinates
    • getAbsoluteCoordinatesRelativeToXY
    • getAlias
    • getElementAtCoordinates
    • getIndexedXhrByAlias
    • getNextAlias
    • getRemoteLocation
    • getRequestsByAlias
    • getXhrTypeByAlias
    • isCy
    • isStopped
    • now
    • queue
    • retry
    • state
    • subject
    • timeout
    • validateAlias
    • verifyUpcomingAssertions

Add FAQ questions from gitter

@jennifer-shehane commented on Tue Aug 08 2017

There are some questions that are asked in the Cypress gitter chat that we'd like to have in a searchable, centralized place - our FAQ.

Please take note of the categories we have in terms of our FAQ:

  • General Questions: Questions someone could ask without ever using Cypress. Maybe they have questions about how it works in general or what we support before diving in.
  • Using Cypress: Questions about how to use Cypress including the API, the Desktop GUI, or running the tests.
  • Dashboard - Questions about our Dashboard service.
  • Company - Questions about Cypress as a company.

Make sure to place it in the correct category. When in doubt, just ask!

The list below is a rough draft. Some questions have rough answers taken from the chat, some have no answers. The questions and answers should be formatted clearly and edited.

Check off any questions from the list after adding it to the examples. Reference the PR to this issue #335.

Questions about Cypress:

  • Is there a way to ignore an exception thrown from my own application or a 3rd party library?
    Read about some of our suggestions for this in our issue here.

  • Could Cypress be used as a replacement for protractor?
    Protractor is essentially a wrapper around Selenium. In most cases Cypress can replace it just fine. There are some limitations to the way Cypress tests are ran (i.e. not via WebDriver, but within the browser under test itself). From my limited experience with Cypress (using it for few weeks now, I'm still evaluating) here are a few things you could test with Selenium (and hence Protractor) but you can't with Cypress:

    • Test in Firefox / IE / Edge.
    • Assert on clipboard contents.
    • Test TAB key (you can write your own .tab() command though, it's just not part of Cypress' API yet)
    • cypress CLI tool doesn't let you to execute a single test, just a single test suite. Not a big deal as you can just use it.only, but would be nice to have (and is offered by many Selenium-based runners)
    • Can't operate native browser dialogs / alerts.
  • can anyone tell me how much the dashboard feature costs?
    We have not released pricing on the Dashboard yet but anticipate it being free for open source projects and having paid plan starting at $99/month

  • Does anyone know if it's possible to write Cypress tests in Typescript?

  • Is there a way to get a project recording link from a successful run/upload?
    I think this is what you're asking for - cypress-io/cypress#494
    In which case, not right now.

  • Is there any documentation about interacting with saving a file using the system dialog? As soon as the system dialog comes up it just waits forever, never times out.
    You can't do this in Cypress currently. You'll need to bypass the way it normally works. Basically you could simply test the behavior before file prompting, like testing that an anchor has the right href. Or you could use cy.request() to programmatically download the file. You don't really need to test that a browser downloads a file because you would expect this to work. You just need to test the mechanism that would cause your application to prompt for file download and retain 100% coverage.

  • Is there any way can take screenshot with console?
    No, not when running headlessly. The console would have to be open the whole time tests are run, then automatically failed when there are JavaScript errors on the page.

  • How do I make Cypress wait for an XHR request?

  • is there CLI option to run in chrome? Or is electron the only way to run headlessly?

  • How do I make conditional based assertions / control flow?

  • How do I run my tests in another browser?

  • Where do I get the key to run my tests in CI?

  • Can I create more than one key for CI?

  • I have an app that needs to be tested across multiple user sessions, like a chat app across 2 browsers. How do I test that?

  • I want to test clicking a link that navigates, how do I wait and check the resulting location url?

  • Is there a way to watch for an xhr request and assert that the response code came back a certain way?

  • How do I pass data to my webserver from Cypress?

  • How do I test drag-n-drop?

  • How do I wait for an element not to exist?

  • How do I do different things depending on whatโ€™s currently in the dom/url/cookies/localstore?

  • Any plans to add "Find React component in DOM" ability, like cy.getReactComponent() or something? (I'd guess you'd want to keep it separate from cy.get())
    you could likely write this as a custom command yourself. Since you have the ability to access window globals, so long as your react application is exposed it should be possible to traverse the trees and access it that way (same as react dev tools essentially)

  • Is it possible to use cypress on .jspa?
    Yes. Cypress works on anything rendered to a browser.

  • Is is possible to catch the promise chain in Cypress?
    No. You cannot add a .catch error handler to a failed command. Read more about how the Cypress commands are not Promises

  • Is there a way to modify the screenshots/video resolution?
    Not at the moment. There is an open issue for this.

  • Can I run cypress on another browser other than Chrome?
    You can read about our currently available browsers here.

  • Does Cypress support ES7?
    Not currently. It uses browserify and babelify with the presets/plugins are hard-coded. There is an open issue for making this configurable.

  • How does one determine what the latest version of Cypress is?
    There are a few ways.

    • The easiest way is probably to check our changelog.
    • You can also check the latest version here.
    • Once we're open source (soon!), we'll have it tagged in the repo too.
  • Is there an ESLint plugin for Cypress or a list of globals?
    describe/it/beforeEach etc globals come from Mocha. So you can use ESLint plugins for Mocha like this one.

  • When I visit my site directly, the certificate is verified, however the browser launched through Cypress is showing it as "Not Secure". Why?
    This is normal. Cypress modifies the traffic between your server and the browser. The browser notices this and displays a certificate warning. However, this is purely cosmetic and does not alter the way your application under test runs in any way, so you can safely ignore this warning.

  • My question is, there's any option to run cypress with devtools open? We want to track network and console issues.
    Yeah, this is definitely the motivation behind cypress-io/cypress#448, there is not a way to run cypress headlessly with devtools open. You may try running the tests locally and select the Electron browser, that's as close as you'll get with devtools open to replicating the environment that was run headlessly.

  • Can I test my Electron app?
    Testing your Electron app will not 'just work', as Cypress is designed to test anything that runs in a browser and Electron is a browser + node.

    That being said, we use Cypress to test our own Desktop app's front end - by stubbing events from Electron. Example: https://github.com/cypress-io/cypress-core-desktop-gui/blob/master/cypress/integration/login_spec.coffee

  • So what benefits would one get for converting one's unit tests from Karma or Jest to Cypress?
    Unit tests are not something we are really trying to solve right now. Most of the cy commands are useless in unit tests. The biggest benefit of writing unit tests in Cypress is that they run in a browser, which has debugger support built in.

    We have internally experimented at doing DOM based component unit testing in Cypress - and that has the possibility of being an excellent "sweet spot" for unit tests. You'd get full DOM support, screenshot support, snapshot testing, and you could then use other cy commands (if need be). But as I mentioned this isn't something we're actively pushing, it just remains a thing that's possible if we wanted to go down that route.

    With that said - we actually believe the best form of testing in Cypress is a combination of a "unit test" mixed with an "e2e test". We don't believe in a "hands off" approach. We want you to modify the state of your application, take shortcuts as much as possible (because you have native access to all objects including your app). In other words, we want you to think in unit tests while you write integration tests.


Add example of using request headers to cy.request doc:

cy.request({ url: 'http://xxx', headers: { 'Content-Type': 'application/vnd.api+json' } })

setup -> set up

It's grammatically correct to say 'Set up tests'

  • 'set up' is two words when describing a verb/action. 'To set up your project'
  • 'setup' = one word when it is an adjective or noun, e.g. 'Complete the setup process', 'During setup of the Dashboard Service'

There are likely many instances of our documentation using 'setup' when we really mean 'set up'. These should be updated.

A few missing urls: once, removelistener

When building see errors from checking url

Error: Constructing {% url %} tag helper failed

    > The source file was: /Users/irinakous/git/cypress-documentation/source/api/events/removelistener.md

    > Could not find a valid doc file in the sidebar.yml for: "once"
      the full url was "once"
    
    at getLocalFile (/Users/irinakous/git/cypress-documentation/lib/url_generator.js:194:5)
Error: Constructing {% url %} tag helper failed

    > The source file was: /Users/irinakous/git/cypress-documentation/source/api/events/on.md

    > Could not find a valid doc file in the sidebar.yml for: "removelistener"
      the full url was "removelistener"
    
    at getLocalFile (/Users/irinakous/git/cypress-documentation/lib/url_generator.js:194:5)

Address searches returning with 0 results

There are some phrases visitors to our documentation have searched for that return 0 results. Many of these could be integrated into the correct place to answer the likely question the visitor had. For example, if there were no results for "firefox", they were likely wanting to know about our browser support. So, we could write "Firefox, IE, etc.... are not currently supported" in this section of this document: https://docs.cypress.io/guides/core-concepts/launching-browsers.html#Browser-Environment.

Another simple way to address a phrase is to add a question about it in our FAQ document.

Check off any phrases from the list after adding it to the docs. Reference the PR to this issue #324.

Previous searches in our docs that returned 0 results:

  • 401
  • 403
  • a11y
  • accessibility
  • autoscroll
  • bearer
  • blacklist
  • browserstack
  • cc
  • clipboard
  • combobox
  • concurrent
  • consoleprop
  • credential
  • datatransfer
  • datepicker
  • datetime
  • defaultroute
  • deletecookie
  • disappear
  • dropevent
  • dropzone
  • envfile
  • geolocation
  • getboundingclientrect
  • geturl
  • firefox
  • forbidden
  • hotkey
  • incognito
  • ionic
  • ie
  • jwt (json web token)
  • lengthalll
  • "load testing"
  • logentries
  • onafterload
  • mockonbeforeload
  • nextjs
  • ng (angular)
  • packagestructure
  • placeholder
  • playground
  • polymer
  • psuedo
  • pushstate
  • queryselectorall (equivalent of cy.get())
  • recursive
  • routerlink
  • safari
  • semicolon
  • sendkey
  • sessionstorage
  • shadow (likely referring to shadow dom)
  • slice
  • swipe
  • smartphone
  • swipegesture
  • telephone
  • testevents
  • tooltip
  • typecasting
  • typeerror
  • waitelement
  • whitepapers
  • window.confirm
  • xp
  • zoom

Docs: cy script conventions

@brian-mann commented on Mon Jun 12 2017

WIP

side + below

cy.visit('/')

cy
.contains('Guides')
.click()
.contains('h1', 'Why Cypress')
.find('.bar')
.should('have.class', 'baz')

cy
.url()
.should('eq', 'foo')
.then(() => {
  cy
  .get('form')
  .submit()
})

always below

cy
.visit('/')

cy
.contains('Guides')
.click()
.contains('h1', 'Why Cypress')
.find('.bar')
.should('have.class', 'baz')

cy
.url()
.should('eq', 'foo')
.then(() => {
  cy
  .get('form')
  .submit()
})

multi line indented

cy.visit('/')

cy
  .contains('Guides')
  .click()
  .contains('h1', 'Why Cypress')
  .find('.bar')
  .should('have.class', 'baz')

cy
  .url()
  .should('eq', 'foo')
  .then(() => {
    cy
      .get('form')
      .submit()
  })

always indented

cy
  .visit('/')

cy
  .contains('Guides')
  .click()
  .contains('h1', 'Why Cypress')
  .find('.bar')
  .should('have.class', 'baz')

cy
  .url()
  .should('eq', 'foo')
  .then(() => {
    cy
      .get('form')
      .submit()
  })

multi line - to the side

cy.visit('/')

cy.contains('Guides')
  .click()
  .contains('h1', 'Why Cypress')
  .find('.bar')
  .should('have.class', 'baz')

cy.url()
  .should('eq', 'foo')
  .then(() => {
    cy.get('form')
      .submit()
  })

@jennifer-shehane commented on Wed Jun 14 2017

There are actually other cases where some code examples are chained on one line. This is how I would write this example:

cy.visit('/')
cy.contains('Guides').click()
  .contains('h1', 'Why Cypress').find('.bar').should('have.class', 'baz')
cy.url().should('eq', 'foo').then(() => {
  cy.get('form').submit()
})

Intro docs page is missing navigations elements (staging)

@bahmutov commented on Tue Aug 29 2017

On staging https://docs-staging.cypress.io/guides/core-concepts/introduction-to-cypress.html is missing navigation aside elements (both left and right).

screen shot 2017-08-28 at 3 20 06 pm

There is a spec to check for that, for now skipped https://github.com/cypress-io/cypress-monorepo/blob/d6be79c4ea9dae4403a660d4890c8df422b26db5/docs/cypress/integration/main_spec.coffee#L119

I am at the end of my wits why this is the case for this particular page only


@jennifer-shehane commented on Tue Aug 29 2017

It looks like there is a an issue with the html being generated, likely some syntax issue in the markdown file. Looking at it now.


@jennifer-shehane commented on Tue Aug 29 2017

The markdown below is being generated into an actual <option> and <select> element when converted to html. This does not happen locally however when I just start the server.

- {% url `.select()` select %} - Select an `<option>` within a `<select>`.

screen shot 2017-08-29 at 9 25 19 am


@brian-mann commented on Tue Aug 29 2017

Npm install again. I've seen this happen in hexo. I have no idea why it
does this.

You might need to rm -rf node_modules and then npm cache clean and then npm
install again

On Tue, Aug 29, 2017 at 9:26 AM, Jennifer Shehane [email protected]
wrote:

The markdown below is being generated into an actual and element when converted to html. This does not happen locally however when I just start the server. {% url .select() select %} - Select an <option> within a <select>. [image: screen shot 2017-08-29 at 9 25 19 am] https://user-images.githubusercontent.com/1271364/29823262-2c771ed6-8c9c-11e7-9b47-55372dce3bcd.png โ€” You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/cypress-io/cypress-monorepo/issues/394#issuecomment-325663041, or mute the thread https://github.com/notifications/unsubscribe-auth/ABNc8JQvqibYyhY4ecAc4Vc4Cgjw0TfRks5sdBGXgaJpZM4PF6bb . @jennifer-shehane commented on Wed Aug 30 2017 Another fun example of these code examples not being escaped properly. ๐Ÿ˜ž Left side is production / rightside is local

Make sure CI docs are up to date with 0.20.0

There are some issue with the CI doc as is:

  • Docker should link to base
  • The CI .yml files should show how to run cypress commands from node_modules.
  • Probably could just be written better in general
  • Better docs on Jenkins

Assertions doc should use $el and not a synchronous query

Current

// this makes it seem like you'd do a synchronous query
// to get the <body> which in Cypress code you never do
expect($('body')).to.have.attr('foo', 'bar')

Proposed

// more accurately reflects how you'd make this
// in Cypress
expect($el).to.have.attr('foo', 'bar')

Explain goal/use-case first for documentation

@jennifer-shehane commented on Tue Jun 20 2017

Inspired by this Twitter thread.

Key Takeaway: Explain first what the goal, or use-case, or desired result is.

Suggested Structure?

# [title]

## Whats the point?
We want to [x] with code that looks like [code]

## How to get there
[docs]

@brian-mann commented on Tue Jun 20 2017

Love it. I'm not saying to do this now, but can/could you audit the first several important guides / docs which need this implemented / improved?

`hexo-prism-plugin` dep `prismjs` updated to broken 1.7.0 version

prismjs (a dependency of hexo-prism-plugin) automatically updated to version 1.7.0, which is broken.

Opened an issue on hexo-prism-plugin: ele828/hexo-prism-plugin#32

Error on npm start/npm run build:

ERROR Plugin load failed: hexo-prism-plugin
TypeError: Cannot read property 'inside' of undefined
    at Object.<anonymous> (/Users/jennifer/Dev/Projects/cypress-documentation/node_modules/prismjs/components/prism-django.js:32:31)
    at Module._compile (module.js:556:32)
    at Object.Module._extensions..js (module.js:565:10)
    at Module.load (module.js:473:32)
    at tryModuleLoad (module.js:432:12)
    at Function.Module._load (module.js:424:3)
    at Module.require (module.js:483:17)
    at require (internal/module.js:20:19)
    at componentsSet.forEach (/Users/jennifer/Dev/Projects/cypress-documentation/node_modules/node-prismjs/index.js:27:27)
    at Array.forEach (native)
    at Object.<anonymous> (/Users/jennifer/Dev/Projects/cypress-documentation/node_modules/node-prismjs/index.js:27:4)
    at Module._compile (module.js:556:32)
    at Object.Module._extensions..js (module.js:565:10)
    at Module.load (module.js:473:32)
    at tryModuleLoad (module.js:432:12)
    at Function.Module._load (module.js:424:3)
    at Module.require (module.js:483:17)
    at require (/Users/jennifer/Dev/Projects/cypress-documentation/node_modules/hexo/lib/hexo/index.js:216:21)
    at /Users/jennifer/Dev/Projects/cypress-documentation/node_modules/hexo-prism-plugin/index.js:5:15
    at /Users/jennifer/Dev/Projects/cypress-documentation/node_modules/hexo/lib/hexo/index.js:232:12
    at tryCatcher (/Users/jennifer/Dev/Projects/cypress-documentation/node_modules/bluebird/js/release/util.js:16:23)
    at Promise._settlePromiseFromHandler (/Users/jennifer/Dev/Projects/cypress-documentation/node_modules/bluebird/js/release/promise.js:512:31)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.