qwik icon indicating copy to clipboard operation
qwik copied to clipboard

Qwik 0.1 Beta Iteration planning

Open manucorporat opened this issue 2 years ago • 6 comments

Qwik 0.1 Beta

Checklist

  • [ ] All public APIs documented
  • [x] Collect and ship all pending breaking changes
  • [x] Review and split all APIs between stable and alpha
  • [x] Most used APIs are stable
  • [ ] Feature freeze
  • [ ] Plan Roadmap to 1.0
  • [ ] Doc site big review
  • [ ] Check minimum requirements (node, npm, yarn, osx, windows...)
  • [ ] Check not major open issues
  • [ ] Clean github issues
  • [ ] Green light from core team
  • [ ] Green light from community
  • [ ] Write blog post
  • [ ] Prepare social media
  • [ ] Schedule small event
  • [ ] Verify all starters with all server
    • [ ] Check actual deployment in all servers (express, cloudflare, netlify)
    • [ ] Check npm start, npm run dev.ssr, npm run build and npm run lint

Requirements

  • Follow semver for new features, raising minor.
  • Next announcement is 1.0-rc0
  • Clear expectations
  • Usable for production
  • Happy path works great (windows, linux, mac)
  • Breaking changes still possible, but not massive
  • Like all software, bugs are expected but minor
  • Cloudflare, netlify, express servers work great

manucorporat avatar Aug 03 '22 14:08 manucorporat

YES!

nnelgxorz avatar Aug 03 '22 14:08 nnelgxorz

Possible API changes

Different prefix of useScopedStyles$()

Currently:

  • useStyles
  • useScopedStyles

Proposal:

  • useStyles
  • useStylesScoped

Benefits, autocompletion in IDEs will help discover the styling apis.

useUserContext()

Name does not reflect what it is, approved renamed to useEnvData()

useWatch, useClientEffect first argument

This two APIs get the tracker as first argument, while useResource$() returns a object. useResource API is more future proof, and it's the prefered by the core team and community, should we update useWatch and useClientEffect for consistency?

QwikCity <Content/>

Does not reflect well what it is, approved rename to <RouterOutlet />

manucorporat avatar Aug 03 '22 15:08 manucorporat

useUserContext() renamed to useEnvData() https://github.com/BuilderIO/qwik/commit/13a81d3eaf1920dbc7ef188e92d676ef70dbd90f

<Content/> renamed to <RouterOutlet/> https://github.com/BuilderIO/qwik/commit/34887e79bd1e705a9816c731d979bb77af2363f1

adamdbradley avatar Aug 03 '22 17:08 adamdbradley

Major public API review: https://github.com/BuilderIO/qwik/pull/916/files

manucorporat avatar Aug 04 '22 10:08 manucorporat

https://github.com/BuilderIO/qwik/pull/912

  • useScopedStyles() -> useStylesScoped()
  • useWatch$((track) => {}) -> useWatch$(({track}) => {})
  • useClientEffect$((track) => {}) -> useClientEffect$(({track}) => {})
  • useServerMount$(): Resource<> -> useServerMount$(): void
  • useMount$(): Resource<> -> useMount$(): void

manucorporat avatar Aug 04 '22 10:08 manucorporat

Design decision for <Host>: https://github.com/BuilderIO/qwik/issues/930

manucorporat avatar Aug 05 '22 06:08 manucorporat

Removing useDocument()? https://github.com/BuilderIO/qwik/issues/1074

Discussion needed

manucorporat avatar Aug 20 '22 18:08 manucorporat

Qwik is great. I like it very much

lzxb avatar Sep 01 '22 01:09 lzxb

We did it! closing issue!

manucorporat avatar Sep 21 '22 10:09 manucorporat

Great job everyone! 👏👏👏

shairez avatar Sep 22 '22 08:09 shairez