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: Update SSG documentation to run build instead of preview #5269

Merged
merged 1 commit into from
Oct 4, 2023
Merged

docs: Update SSG documentation to run build instead of preview #5269

merged 1 commit into from
Oct 4, 2023

Conversation

ibousfiha
Copy link
Contributor

Overview

This PR aims to correct the documentation for SSG, specifically to suggest running build instead of preview.

What is it?

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

Description

This PR updates the SSG documentation to replace the recommendation of using the preview command with the build command for generating static pages. This change is important to highlight because the preview command currently does not generate any HTML static files, whereas the build command does. This ensures developers are fully aware of what each command will yield.

Use cases and why

  • Clarity: The documentation should accurately guide the developer in generating static pages, which is achieved by using build.
  • Avoiding Confusion: Mentioning that preview does not generate HTML static files clarifies its limitations.

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

Fix the docs about SSG using npm run build instead of preview
@netlify
Copy link

netlify bot commented Oct 4, 2023

👷 Deploy request for qwik-insights pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit 0d28583

@ibousfiha ibousfiha changed the title Update SSG documentation to run build instead of preview docs: Update SSG documentation to run build instead of preview Oct 4, 2023
@wmertens
Copy link
Member

wmertens commented Oct 4, 2023

Would it not be better to have preview generate the SSG pages instead?

1 similar comment
@wmertens
Copy link
Member

wmertens commented Oct 4, 2023

Would it not be better to have preview generate the SSG pages instead?

@ibousfiha
Copy link
Contributor Author

ibousfiha commented Oct 4, 2023

Would it not be better to have preview generate the SSG pages instead?

I'm on the same page with you; having the preview command generate SSG pages would be ideal. I've already brought up this issue on Discord, and @mhevery suggested updating the documentation for now (Discord conversation link).

Additionally, when I attempted to remove the --ssr flag from the preview command in package.json, it resulted in the following error:

Could not resolve entry module "src/entry.preview.tsx/index.html".
error during build:
RollupError: Could not resolve entry module "src/entry.preview.tsx/index.html".
    at error (file:///Users/issambousfiha/Projects/qwik-app/node_modules/rollup/dist/es/shared/node-entry.js:2287:30)
    at ModuleLoader.loadEntryModule (file:///Users/issambousfiha/Projects/qwik-app/node_modules/rollup/dist/es/shared/node-entry.js:24881:20)
    at async Promise.all (index 0)

I can open a separate issue to address this problem. Would that be a good next step?

@wmertens
Copy link
Member

wmertens commented Oct 4, 2023

Thanks! Yes, an issue for fixing preview would be good.

@wmertens wmertens enabled auto-merge (squash) October 4, 2023 10:26
@wmertens wmertens merged commit af3e401 into QwikDev:main Oct 4, 2023
19 of 20 checks passed
kodiakhq bot pushed a commit to ascorbic/unpic-img that referenced this pull request Oct 8, 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)) | [`1.2.12` -> `1.2.13`](https://renovatebot.com/diffs/npm/@builder.io%2fqwik/1.2.12/1.2.13) | [![age](https://developer.mend.io/api/mc/badges/age/npm/@builder.io%2fqwik/1.2.13?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![adoption](https://developer.mend.io/api/mc/badges/adoption/npm/@builder.io%2fqwik/1.2.13?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![passing](https://developer.mend.io/api/mc/badges/compatibility/npm/@builder.io%2fqwik/1.2.12/1.2.13?slim=true)](https://docs.renovatebot.com/merge-confidence/) | [![confidence](https://developer.mend.io/api/mc/badges/confidence/npm/@builder.io%2fqwik/1.2.12/1.2.13?slim=true)](https://docs.renovatebot.com/merge-confidence/) |

---

### Release Notes

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

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

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

#### What's Changed

-   fix(insights): wrapper style by [@&#8203;gioboa](https://togithub.com/gioboa) in [QwikDev/qwik#5193
-   docs: fix typos by [@&#8203;igorbabko](https://togithub.com/igorbabko) in [QwikDev/qwik#5195
-   fix(qwik-auth): allow multiple set-cookie headers by [@&#8203;ulic75](https://togithub.com/ulic75) in [QwikDev/qwik#5194
-   feat(insights): return prefetch list per route by [@&#8203;mhevery](https://togithub.com/mhevery) in [QwikDev/qwik#5197
-   feat(insights): return prefetch list per route by [@&#8203;mhevery](https://togithub.com/mhevery) in [QwikDev/qwik#5198
-   chore(qwik-auth): v0.1.3 by [@&#8203;mhevery](https://togithub.com/mhevery) in [QwikDev/qwik#5201
-   feat(cli): add barrel template to `new` command by [@&#8203;dapids](https://togithub.com/dapids) in [QwikDev/qwik#5202
-   docs: add `dimension.dev` to showcase by [@&#8203;necatikcl](https://togithub.com/necatikcl) in [QwikDev/qwik#5200
-   fix(core): Added StringSerializer for strings that start with the prefixes of serializers. by [@&#8203;genki](https://togithub.com/genki) in [QwikDev/qwik#5176
-   fix(serializers): fix for serialization of an empty set or map by [@&#8203;Varixo](https://togithub.com/Varixo) in [QwikDev/qwik#5209
-   docs: add qwik-spin-delay library by [@&#8203;harshmangalam](https://togithub.com/harshmangalam) in [QwikDev/qwik#5214
-   docs(ecosystem): add qwik-image library by [@&#8203;gioboa](https://togithub.com/gioboa) in [QwikDev/qwik#5216
-   chore: add prettier-plugin-tailwindcss to tailwind starter ([#&#8203;5217](https://togithub.com/BuilderIO/qwik/issues/5217)) by [@&#8203;nsdonato](https://togithub.com/nsdonato) in [QwikDev/qwik#5217
-   docs: Correct image size and CLS in resumable example by [@&#8203;mhevery](https://togithub.com/mhevery) in [QwikDev/qwik#5220
-   docs: fix url for useVisibleTask by [@&#8203;nsdonato](https://togithub.com/nsdonato) in [QwikDev/qwik#5223
-   feat: bootstrap integration adapter  by [@&#8203;mhevery](https://togithub.com/mhevery) in [QwikDev/qwik#5222
-   chore: update file path in next-steps.tsx by [@&#8203;Craiqser](https://togithub.com/Craiqser) in [QwikDev/qwik#5212
-   refactor: remove extraneous isElement call by [@&#8203;wmertens](https://togithub.com/wmertens) in [QwikDev/qwik#5210
-   docs: fix edit this page for deprecated features by [@&#8203;nsdonato](https://togithub.com/nsdonato) in [QwikDev/qwik#5224
-   chore: update firebase starter to contemplate dist folder by [@&#8203;nsdonato](https://togithub.com/nsdonato) in [QwikDev/qwik#5225
-   feat(cachecontrol): add second `target` argument to cacheControl by [@&#8203;maiieul](https://togithub.com/maiieul) in [QwikDev/qwik#5226
-   fix: should SSR render if accept header includes */* by [@&#8203;SamVerschueren](https://togithub.com/SamVerschueren) in [QwikDev/qwik#5234
-   docs: fix 404 links by [@&#8203;mhevery](https://togithub.com/mhevery) in [QwikDev/qwik#5236
-   docs: Add frostytools.com to pages.json by [@&#8203;n8sabes](https://togithub.com/n8sabes) in [QwikDev/qwik#5239
-   docs: fix typo by [@&#8203;the-r3aper7](https://togithub.com/the-r3aper7) in [QwikDev/qwik#5241
-   chore(contributing.md): remove unnecessary step to test against docs … by [@&#8203;maiieul](https://togithub.com/maiieul) in [QwikDev/qwik#5244
-   chore(contributing.md): added info when package linking doesn't work by [@&#8203;maiieul](https://togithub.com/maiieul) in [QwikDev/qwik#5245
-   docs: Build Showcase by [@&#8203;n8sabes](https://togithub.com/n8sabes) in [QwikDev/qwik#5242
-   docs: documentation link and text for directory-based routing by [@&#8203;ryo-manba](https://togithub.com/ryo-manba) in [QwikDev/qwik#5246
-   feat(labs): Add json debugging tool by [@&#8203;mhevery](https://togithub.com/mhevery) in [QwikDev/qwik#5259
-   feat(core): Allow useContext in same elem as provider by [@&#8203;wmertens](https://togithub.com/wmertens) in [QwikDev/qwik#5258
-   docs(routing): add Link prefetch documentation (alternative) by [@&#8203;maiieul](https://togithub.com/maiieul) in [QwikDev/qwik#5248
-   docs(labs): document devtools/json by [@&#8203;mhevery](https://togithub.com/mhevery) in [QwikDev/qwik#5260
-   fix(starter): localize configuration by [@&#8203;gioboa](https://togithub.com/gioboa) in [QwikDev/qwik#5262
-   docs: fix typos by [@&#8203;igorbabko](https://togithub.com/igorbabko) in [QwikDev/qwik#5265
-   docs(integrations): add valibot to modular forms guide by [@&#8203;fabian-hiller](https://togithub.com/fabian-hiller) in [QwikDev/qwik#5252
-   docs: Update SSG documentation to run build instead of preview by [@&#8203;ibousfiha](https://togithub.com/ibousfiha) in [QwikDev/qwik#5269
-   fix(starter): localize container attribute by [@&#8203;tzdesign](https://togithub.com/tzdesign) in [QwikDev/qwik#5268
-   fix: A bug fix [#&#8203;5104](https://togithub.com/BuilderIO/qwik/issues/5104) by [@&#8203;Charlygraphy23](https://togithub.com/Charlygraphy23) in [QwikDev/qwik#5267
-   docs(state): Add 'key' prop to list items by [@&#8203;nicvazquez](https://togithub.com/nicvazquez) in [QwikDev/qwik#5250
-   docs: add note about `onRequest` middleware exported from `serverAuth$` by [@&#8203;jakovljevic-mladen](https://togithub.com/jakovljevic-mladen) in [QwikDev/qwik#5264
-   docs(labs): update path for devtools to include https by [@&#8203;mhevery](https://togithub.com/mhevery) in [QwikDev/qwik#5271
-   docs: updated phrasing for clarity by [@&#8203;bodhicodes](https://togithub.com/bodhicodes) in [QwikDev/qwik#5273
-   fix: Bun adapter polyfill and redirect fix by [@&#8203;EamonHeffernan](https://togithub.com/EamonHeffernan) in [QwikDev/qwik#5272
-   fix: Pr local dev docker by [@&#8203;SauravChanda](https://togithub.com/SauravChanda) in [QwikDev/qwik#5237
-   refactor(core): remove useContextBoundary by [@&#8203;wmertens](https://togithub.com/wmertens) in [QwikDev/qwik#5274
-   fix: shell script update in README file by [@&#8203;harshmangalam](https://togithub.com/harshmangalam) in [QwikDev/qwik#5275
-   docs: improve advanced routing documentation by [@&#8203;jakovljevic-mladen](https://togithub.com/jakovljevic-mladen) in [QwikDev/qwik#5276
-   chore: 1.2.13 by [@&#8203;mhevery](https://togithub.com/mhevery) in [QwikDev/qwik#5277

#### New Contributors

-   [@&#8203;igorbabko](https://togithub.com/igorbabko) made their first contribution in [QwikDev/qwik#5195
-   [@&#8203;dapids](https://togithub.com/dapids) made their first contribution in [QwikDev/qwik#5202
-   [@&#8203;maiieul](https://togithub.com/maiieul) made their first contribution in [QwikDev/qwik#5226
-   [@&#8203;SamVerschueren](https://togithub.com/SamVerschueren) made their first contribution in [QwikDev/qwik#5234
-   [@&#8203;ryo-manba](https://togithub.com/ryo-manba) made their first contribution in [QwikDev/qwik#5246
-   [@&#8203;ibousfiha](https://togithub.com/ibousfiha) made their first contribution in [QwikDev/qwik#5269
-   [@&#8203;Charlygraphy23](https://togithub.com/Charlygraphy23) made their first contribution in [QwikDev/qwik#5267
-   [@&#8203;nicvazquez](https://togithub.com/nicvazquez) made their first contribution in [QwikDev/qwik#5250
-   [@&#8203;bodhicodes](https://togithub.com/bodhicodes) made their first contribution in [QwikDev/qwik#5273
-   [@&#8203;SauravChanda](https://togithub.com/SauravChanda) made their first contribution in [QwikDev/qwik#5237

**Full Changelog**: QwikDev/qwik@v1.2.12...v1.2.13

</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:eyJjcmVhdGVkSW5WZXIiOiIzNy4wLjMiLCJ1cGRhdGVkSW5WZXIiOiIzNy4wLjMiLCJ0YXJnZXRCcmFuY2giOiJtYWluIn0=-->
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