Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: clarify clean: true and default include #387

Merged
merged 1 commit into from
Jul 21, 2022

Conversation

agilgur5
Copy link
Collaborator

@agilgur5 agilgur5 commented Jul 20, 2022

Summary

Minor docs clarifications, fixes, and style consistency

Details

  • the docs for clean don't seem to have been updated after f15cb84 (Don't create cache dir when clean: true #68), which slightly changed how it works

  • also clarify that "wipes out cache" means it deletes all previous caches by saying "wipes any existing cache" instead

  • fix the include default explanation to mention .tsx files as well, since the regex includes those

    • also add code backticks and capitalize TypeScript etc (guess I missed this option in my previous docs PRs? or I intentionally left it as a separate change a while ago...)
  • also add code backticks around node_modules in cacheRoot as well while at it

  • use non-rendered newlines between sentences for markdown style consistency

@agilgur5 agilgur5 added scope: docs Documentation could be improved. Or changes that only affect docs kind: internal Changes only affect the internals, and _not_ the public API or external-facing docs labels Jul 20, 2022
- the docs for `clean` don't seem to have been updated with f15cb84, which slightly changed how it works
- also clarify that "wipes out cache" means it deletes _all_ previous caches by saying "wipes any existing cache" instead

- fix the `include` default explanation to mention `.tsx` files as well, since the regex includes those
  - also add code backticks and capitalize TypeScript etc (guess I missed this option in my previous PRs? or I intentionally left it as a separate change a while ago...)

- also add code backticks around `node_modules` in `cacheRoot` as well while at it

- use non-rendered newlines between sentences for markdown style consistency
@agilgur5 agilgur5 added the scope: cache Related to the cache label Jul 20, 2022
@agilgur5
Copy link
Collaborator Author

agilgur5 commented Jul 20, 2022

Windows CI failures are due to #385
(we also don't have any docs tests at this time, so docs-only changes can't result in a CI failure anyway)

@ezolenko ezolenko merged commit e5e3ccd into ezolenko:master Jul 21, 2022
@agilgur5 agilgur5 added kind: dx Improvements to dev experience, e.g. error messages, logging, external-facing docs, etc and removed kind: internal Changes only affect the internals, and _not_ the public API or external-facing docs labels Jul 22, 2022
@agilgur5 agilgur5 deleted the docs-clarify-clean branch July 2, 2023 21:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
kind: dx Improvements to dev experience, e.g. error messages, logging, external-facing docs, etc scope: cache Related to the cache scope: docs Documentation could be improved. Or changes that only affect docs
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants