sourcegraph/doc
Quinn Slack de613e92b6
use esbuild for client/web builds (#57365)
Use [esbuild](https://esbuild.github.io/) instead of Webpack for builds of `client/web`, for faster builds (dev and prod) and greater dev-prod parity. This PR completely removes all use of Webpack in this repository.

`client/web` is the last build target that still uses Webpack; all others have been recently migrated to esbuild. Most devs here have been using esbuild for local dev of `client/web` for the last 6-12 months anyway. The change here is that now our production builds will be built by esbuild.

All sg commands, integration/e2e tests, etc., continue to work as-is. The bundlesize report will take a while to stabilize because the new build products use different filenames.

## Benchmarks

Running `pnpm run generate && time pnpm -C client/web run task:gulp webBuild` and taking the `time` output from the last command:

- Webpack: 62.5s
- esbuild: 6.7s

Note: This understates esbuild's victory for 2 reasons: (1) because esbuild is building both the main and embed entrypoints, whereas Webpack only builds the main entrypoint in this benchmark) and (2) because a lot of it is in the fixed startup time of `gulp`; esbuild incremental rebuilds during local dev only take ~1s.

## Notes

We no longer use Babel to produce web builds (we use esbuild), so we don't need any Babel plugins that optimize the output or improve browser compatibility. Right now, Babel is only used by Jest (for tests) and by Bazel as an intermediate step.
2023-10-23 10:59:06 -07:00
..
_resources WIP: Add Core Concepts (#57592) 2023-10-18 11:07:51 -07:00
admin Add changelog entries about removal of GitHub proxy (#57753) 2023-10-23 16:15:39 +02:00
api Add search pagination limitations and recommendation (#53479) 2023-06-14 15:32:37 +01:00
batch_changes Remove self from CODENOTIFY/OWNERS (#56451) 2023-09-08 15:37:51 +01:00
cli docs: add how-to for revoking access tokens (#57708) 2023-10-19 11:26:12 +00:00
cloud fix URL placeholder in docs (#57063) 2023-09-27 14:12:17 +00:00
code_insights Fix typos in documentation (#52407) 2023-06-21 07:52:54 -07:00
code_monitoring Improve readability on small screens and reduce layout shift (#55600) 2023-08-07 08:54:41 -07:00
code_navigation Add follow-up feedback to Core Concepts (#57752) 2023-10-19 13:24:28 -07:00
code_search Search: enable repo:has.topic() for GitLab (#57649) 2023-10-19 20:46:56 +00:00
cody Updates to 'Installing Cody in VS Code' (#57036) 2023-10-23 16:27:08 +00:00
dev use esbuild for client/web builds (#57365) 2023-10-23 10:59:06 -07:00
dotcom Note differences in sourcegraph.com (#46018) 2022-12-31 07:20:02 +00:00
getting-started Including Maedah's fix (#57195) 2023-09-29 15:31:33 +00:00
integration Adding GitLab Solution Brief link to GitLab doc page (#52641) 2023-07-28 20:02:47 -04:00
notebooks update notebook embedding with browser restrictions and workaround (#52200) 2023-05-19 15:57:17 +00:00
own gitserver: Make gitserver code internal (#57122) 2023-10-04 14:14:47 +02:00
sla add premium support doc to docs (#56985) 2023-09-27 12:05:27 -07:00
tutorials Implement new nav for docs website + Cody revamp (#55742) 2023-08-14 12:59:02 -07:00
BUILD.bazel doc/telemetry: add exported events schema (#57106) 2023-09-28 13:51:44 -07:00
CHANGELOG.md doc: symlink CHANGELOG.md to docs for better search results (#22918) 2021-07-16 23:25:02 +08:00
CODENOTIFY chore: clean up CODENOTIFY for @sourcegraph/delivery (#57046) 2023-09-26 15:20:42 -04:00
dependency_decisions.yml enterprise: Move last directory out (#57392) 2023-10-05 20:15:40 +00:00
docsite.json insights: re-index docs (#32415) 2022-03-10 10:05:59 -07:00
index.md Remove docs link for downloading code search app (#56917) 2023-09-21 16:01:47 -04:00
KNOWN-ISSUES.md Ajb doc update 23 (#56656) 2023-09-15 17:04:23 +00:00
serve.sh bzl: bazelify docsite and doc/cli/reference generation (#54538) 2023-07-03 16:12:44 +02:00
sidebar.md WIP: Add Core Concepts (#57592) 2023-10-18 11:07:51 -07:00
test.sh bzl: wrap docsite check into //doc:test (#54376) 2023-06-28 21:00:54 +02:00