Skip to content

(docs): improve test watch mode docs#395

Merged
swyxio merged 1 commit into
jaredpalmer:masterfrom
agilgur5:fix-docs-test-watch
Dec 28, 2019
Merged

(docs): improve test watch mode docs#395
swyxio merged 1 commit into
jaredpalmer:masterfrom
agilgur5:fix-docs-test-watch

Conversation

@agilgur5

@agilgur5 agilgur5 commented Dec 27, 2019

Copy link
Copy Markdown
Collaborator
  • it was not clearly stated that CI=true was what needed to be added,
    so explicitly state that

  • similarly, --color was an unnecessary option to pass and may have
    caused confusion, potentially making users believe that it was
    necessary in order to disable watch mode

    • also, --color does not seem to be a valid option of Jest, but
      --colors (note the s) is used to force highlighting in non-TTY
  • also, properly format package.json example as JSON, including the
    "scripts" section

  • and add a test:watch script for context, making more explicit the
    difference between non-watch and watch mode

Follow-up to #385 , related to #319, #366 . Though this documentation does make me wonder whether it makes sense to have --watch as a default. It's much more intuitive to pass --watch than to prefix with CI=true

- it was not clearly stated that CI=true was what needed to be added,
  so explicitly state that
- similarly, --color was an unnecessary option to pass and may have
  caused confusion, potentially making users believe that it was
  necessary in order to disable watch mode
  - also, --color does not seem to be a valid option of Jest, but
    --colors (note the s) is used to force highlighting in non-TTY

- also, properly format package.json example as JSON, including the
  "scripts" section
- and add a test:watch script for context, making more explicit the
  difference between non-watch and watch mode
@swyxio swyxio merged commit 531010e into jaredpalmer:master Dec 28, 2019
@swyxio

swyxio commented Dec 28, 2019

Copy link
Copy Markdown
Collaborator

feel free to propose --watch in a separate issue. altho i think if u followed those issues, jared had a strong opinion that watch should be default

@agilgur5

Copy link
Copy Markdown
Collaborator Author

altho i think if u followed those issues, jared had a strong opinion that watch should be default

Unless I'm missing something, I think this is the only comment Jared made on it: #319 (comment) , which didn't seem strong?

But yea would be a separate issue, perhaps that should be voted on by users

@swyxio

swyxio commented Dec 28, 2019

Copy link
Copy Markdown
Collaborator

its not really up to a vote, this is Jared's project. but do what you think is right :)

@swyxio

swyxio commented Jan 9, 2020

Copy link
Copy Markdown
Collaborator

heads up - we have decided to undo this move. will not run in watch mode by default. sorry for the flipflop. #408

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants