Skip to content

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 force-pushed the docs-clarify-clean branch from f58154d to d333709 Compare July 20, 2022 06:49
@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