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(usevisibletask$): reduce eslint noUseVisibleTask message + transfer to docs #5583

Merged
merged 2 commits into from
Dec 15, 2023

Conversation

maiieul
Copy link
Contributor

@maiieul maiieul commented Dec 14, 2023

Overview

What is it?

  • Feature / enhancement
  • Bug
  • Docs / tests / types / typos

Description

Reduced the eslint warning message for noUseVisibleTask as this warning can add up a lot of noise when it comes many times at once (especially codebases that are transitioning to 1.3).

Most other warnings are rather small, so I made it consistent with the other warnings.

I added the corresponding documentation. On their IDE, users can click on the qwik/no-use-visible-task link when hovering the warning. On the console, the warning redirects to where this happens in the IDE.

I believe this would result in less frustration, especially since useVisibleTask$ is sometimes unavoidable.

Checklist:

  • My code follows the developer guidelines of this project
  • I have performed a self-review of my own code
  • I have made corresponding changes to the documentation
  • Added new tests to cover the fix / functionality

Sorry, something went wrong.

Copy link

netlify bot commented Dec 14, 2023

👷 Deploy request for qwik-insights pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit b92e32d

@maiieul maiieul changed the title docs(usevisibletask$): reduce eslint noUseVisibleTask message + trans… docs(usevisibletask$): reduce eslint noUseVisibleTask message + transfer to docs Dec 14, 2023

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
@maiieul
Copy link
Contributor Author

maiieul commented Dec 15, 2023

That should be a good middleground. It provides a succint explanation on why useVisibleTask$ is problematic, what can be used as an alternative (people can easily search for them in the docs), and how to exceptionally disable the rule.

Feel free to tell me if you think it's still too succint, or if you have any other suggestion :)

Copy link
Member

@gioboa gioboa left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @maiieul I like it

@gioboa gioboa added COMP: docs Improvements or additions to documentation COMP: eslint labels Dec 15, 2023
@gioboa gioboa merged commit df8ce85 into QwikDev:main Dec 15, 2023
kodiakhq bot referenced this pull request in ascorbic/unpic-img Dec 17, 2023
[![Mend Renovate](https://app.renovatebot.com/images/banner.svg)](https://renovatebot.com)

This PR contains the following updates:

| Package | Change | Age | Adoption | Passing | Confidence |
|---|---|---|---|---|---|
| [@builder.io/qwik](https://qwik.builder.io/) ([source](https://togithub.com/BuilderIO/qwik/tree/HEAD/packages/qwik)) | [`1.3.0` -> `1.3.1`](https://renovatebot.com/diffs/npm/@builder.io%2fqwik/1.3.0/1.3.1) | [![age](https://developer.mend.io/api/mc/badges/age/npm/@builder.io%2fqwik/1.3.1?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![adoption](https://developer.mend.io/api/mc/badges/adoption/npm/@builder.io%2fqwik/1.3.1?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![passing](https://developer.mend.io/api/mc/badges/compatibility/npm/@builder.io%2fqwik/1.3.0/1.3.1?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![confidence](https://developer.mend.io/api/mc/badges/confidence/npm/@builder.io%2fqwik/1.3.0/1.3.1?slim=true)](https://docs.renovatebot.com/merge-confidence/) |

---

### Release Notes

<details>
<summary>BuilderIO/qwik (@&#8203;builder.io/qwik)</summary>

### [`v1.3.1`](https://togithub.com/BuilderIO/qwik/releases/tag/v1.3.1)

[Compare Source](https://togithub.com/BuilderIO/qwik/compare/v1.3.0...v1.3.1)

##### What's Changed

-   fix(playground): block 1.3.0 by [@&#8203;wmertens](https://togithub.com/wmertens) in [https://github.com/BuilderIO/qwik/pull/5538](https://togithub.com/BuilderIO/qwik/pull/5538)
-   docs: show-updated-docs by [@&#8203;AmirSa12](https://togithub.com/AmirSa12) in [https://github.com/BuilderIO/qwik/pull/5516](https://togithub.com/BuilderIO/qwik/pull/5516)
-   docs: (add list item) Add qwik-d3 to the library list by [@&#8203;gilf](https://togithub.com/gilf) in [https://github.com/BuilderIO/qwik/pull/5544](https://togithub.com/BuilderIO/qwik/pull/5544)
-   docs: add qwik-storefront-ui library by [@&#8203;gioboa](https://togithub.com/gioboa) in [https://github.com/BuilderIO/qwik/pull/5548](https://togithub.com/BuilderIO/qwik/pull/5548)
-   docs: change image url by [@&#8203;gioboa](https://togithub.com/gioboa) in [https://github.com/BuilderIO/qwik/pull/5549](https://togithub.com/BuilderIO/qwik/pull/5549)
-   chore(starters): add type module to package.json  by [@&#8203;nelsonprsousa](https://togithub.com/nelsonprsousa) in [https://github.com/BuilderIO/qwik/pull/5553](https://togithub.com/BuilderIO/qwik/pull/5553)
-   refactor(types): optimize, QRL props, PropsOf, track(Signal) type, ... by [@&#8203;wmertens](https://togithub.com/wmertens) in [https://github.com/BuilderIO/qwik/pull/5550](https://togithub.com/BuilderIO/qwik/pull/5550)
-   fix(repl): don't propose broken versions by [@&#8203;wmertens](https://togithub.com/wmertens) in [https://github.com/BuilderIO/qwik/pull/5560](https://togithub.com/BuilderIO/qwik/pull/5560)
-   fix: remove dependency on vitefu causing playground failures by [@&#8203;mhevery](https://togithub.com/mhevery) in [https://github.com/BuilderIO/qwik/pull/5562](https://togithub.com/BuilderIO/qwik/pull/5562)
-   fix: better deprecation notice on qwikevents by [@&#8203;wmertens](https://togithub.com/wmertens) in [https://github.com/BuilderIO/qwik/pull/5568](https://togithub.com/BuilderIO/qwik/pull/5568)
-   fix: use existing local .eslintrc configuration by [@&#8203;gioboa](https://togithub.com/gioboa) in [https://github.com/BuilderIO/qwik/pull/5563](https://togithub.com/BuilderIO/qwik/pull/5563)
-   test(lint): break up lint tests into separate files by [@&#8203;mhevery](https://togithub.com/mhevery) in [https://github.com/BuilderIO/qwik/pull/5572](https://togithub.com/BuilderIO/qwik/pull/5572)
-   refactor(qwik): add `__qwik_serializable__` brand to types by [@&#8203;mhevery](https://togithub.com/mhevery) in [https://github.com/BuilderIO/qwik/pull/5576](https://togithub.com/BuilderIO/qwik/pull/5576)
-   fix(lint): allow event methods to capture `PropFunction` by [@&#8203;mhevery](https://togithub.com/mhevery) in [https://github.com/BuilderIO/qwik/pull/5578](https://togithub.com/BuilderIO/qwik/pull/5578)
-   chore(eslint-plugin-qwik): add 'qwik/no-use-visible-task': 'warn' to strict by [@&#8203;maiieul](https://togithub.com/maiieul) in [https://github.com/BuilderIO/qwik/pull/5575](https://togithub.com/BuilderIO/qwik/pull/5575)
-   fix: `server$` and AbortSignal types by [@&#8203;mhevery](https://togithub.com/mhevery) in [https://github.com/BuilderIO/qwik/pull/5581](https://togithub.com/BuilderIO/qwik/pull/5581)
-   fix(qwik): restore bivarience hack by [@&#8203;mhevery](https://togithub.com/mhevery) in [https://github.com/BuilderIO/qwik/pull/5587](https://togithub.com/BuilderIO/qwik/pull/5587)
-   chore(insights): correct failing build by [@&#8203;mhevery](https://togithub.com/mhevery) in [https://github.com/BuilderIO/qwik/pull/5586](https://togithub.com/BuilderIO/qwik/pull/5586)
-   docs(usevisibletask$): reduce eslint noUseVisibleTask message + transfer to docs by [@&#8203;maiieul](https://togithub.com/maiieul) in [https://github.com/BuilderIO/qwik/pull/5583](https://togithub.com/BuilderIO/qwik/pull/5583)
-   docs: remove console warning by [@&#8203;gioboa](https://togithub.com/gioboa) in [https://github.com/BuilderIO/qwik/pull/5590](https://togithub.com/BuilderIO/qwik/pull/5590)
-   fix(qwik-city): Scroll Position doesn't reset to 0 when it was triggered by an Action. by [@&#8203;iamriajul](https://togithub.com/iamriajul) in [https://github.com/BuilderIO/qwik/pull/5588](https://togithub.com/BuilderIO/qwik/pull/5588)
-   feat(qwik): Experimental support for synchronous QRL `sync$()`. by [@&#8203;mhevery](https://togithub.com/mhevery) in [https://github.com/BuilderIO/qwik/pull/5545](https://togithub.com/BuilderIO/qwik/pull/5545)
-   chore: 1.3.1 by [@&#8203;mhevery](https://togithub.com/mhevery) in [https://github.com/BuilderIO/qwik/pull/5595](https://togithub.com/BuilderIO/qwik/pull/5595)

##### New Contributors

-   [@&#8203;AmirSa12](https://togithub.com/AmirSa12) made their first contribution in [https://github.com/BuilderIO/qwik/pull/5516](https://togithub.com/BuilderIO/qwik/pull/5516)
-   [@&#8203;iamriajul](https://togithub.com/iamriajul) made their first contribution in [https://github.com/BuilderIO/qwik/pull/5588](https://togithub.com/BuilderIO/qwik/pull/5588)

**Full Changelog**: QwikDev/qwik@v1.3.0...v1.3.1

</details>

---

### Configuration

📅 **Schedule**: Branch creation - "after 9pm on sunday" (UTC), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR has been generated by [Mend Renovate](https://www.mend.io/free-developer-tools/renovate/). View repository job log [here](https://developer.mend.io/github/ascorbic/unpic-img).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzNy45My4xIiwidXBkYXRlZEluVmVyIjoiMzcuOTMuMSIsInRhcmdldEJyYW5jaCI6Im1haW4ifQ==-->
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
COMP: docs Improvements or additions to documentation COMP: eslint
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants