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(compiler): add type docs for esmLoaderPath #1364

Merged
merged 7 commits into from
Mar 1, 2024

Conversation

christian-bromann
Copy link
Member

Adding docs for esmLoaderPath.

See also ionic-team/stencil#5418

@christian-bromann christian-bromann requested a review from a team as a code owner February 28, 2024 00:46
@christian-bromann christian-bromann requested review from rwaskiewicz and tanner-reits and removed request for a team February 28, 2024 00:46
Copy link

vercel bot commented Feb 28, 2024

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
stencil-docs ✅ Ready (Inspect) Visit Preview 💬 Add feedback Mar 1, 2024 8:32pm

versioned_docs/version-v2/output-targets/dist.md Outdated Show resolved Hide resolved
*default: `/dist/loader`*

Provide a custom path for the ESM loader directory, containing files you can import in an initiation script within your application to register all your components for lazy loading.

Copy link
Contributor

Choose a reason for hiding this comment

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

Can we expand on this? I'm not sure that as a user, I'd know enough here to start using this flag. To start, it might be worthwhile to include an example directory structure, setting with a custom value for esmLoaderPath, and explaining how setting esmLoaderPath affects the output of Stencil.

Copy link
Contributor

Choose a reason for hiding this comment

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

Agree. Maybe we need an additional section that talks about lazy loading and what the loader does? We could pull some of this out of the "How is this different from "dist-custom-elements" output target?" section.

Copy link
Member Author

Choose a reason for hiding this comment

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

I added a section to the loader script and also added an example how modifying the option has an impact on the user of a stencil library.

*default: `/dist/loader`*

Provide a custom path for the ESM loader directory, containing files you can import in an initiation script within your application to register all your components for lazy loading.

Copy link
Contributor

Choose a reason for hiding this comment

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

Agree. Maybe we need an additional section that talks about lazy loading and what the loader does? We could pull some of this out of the "How is this different from "dist-custom-elements" output target?" section.

Copy link
Contributor

@rwaskiewicz rwaskiewicz left a comment

Choose a reason for hiding this comment

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

One non-block ask

docs/output-targets/dist.md Outdated Show resolved Hide resolved
Copy link
Contributor

@tanner-reits tanner-reits left a comment

Choose a reason for hiding this comment

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

👍

docs/output-targets/dist.md Outdated Show resolved Hide resolved
@christian-bromann
Copy link
Member Author

Thanks for the review folks, I applied the changes to all other docs versions (except v2).

@christian-bromann christian-bromann merged commit 0ff00ab into main Mar 1, 2024
4 of 5 checks passed
@christian-bromann christian-bromann deleted the cb/esmLoaderPath-docs branch March 1, 2024 20:31
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.

3 participants