Skip to content

docs: clarify serve mode in-memory outputs and servedir-only use - #60

Open
dieterstemmet wants to merge 1 commit into
esbuild:mainfrom
dieterstemmet:docs/clarify-serve-mode
Open

dieterstemmet wants to merge 1 commit into
esbuild:mainfrom
dieterstemmet:docs/clarify-serve-mode

Conversation

@dieterstemmet

Copy link
Copy Markdown

Summary

  • Document that serve mode keeps build outputs in memory (overlay) and does not write outdir/outfile unless a normal build also runs.
  • Document that --servedir=... alone (no entry points) is a plain static file server with no transform/bundle step.

Fixes evanw/esbuild#4393.

Test plan

  • Read the Serve section on a local docs build / preview for flow with the existing rebuild and production warnings.
  • Confirm the in-memory and servedir-only notes match current esbuild CLI behavior.

Verified

  • Docs-only change in src/content/api.yml.

Spell out that serve overlays build results in memory instead of writing
outdir, and that --servedir alone acts as a static file server.

Related to evanw/esbuild#4393.

This branch has not been deployed

No deployments
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.

[docs] Clarify serve behaviour

1 participant