Skip to content

Add very basic documentation of built-in extension structure #299045

Merged
mjbvz merged 5 commits intomicrosoft:mainfrom
mjbvz:dev/mjbvz/negative-quokka
Mar 3, 2026
Merged

Add very basic documentation of built-in extension structure #299045
mjbvz merged 5 commits intomicrosoft:mainfrom
mjbvz:dev/mjbvz/negative-quokka

Conversation

@mjbvz
Copy link
Copy Markdown
Collaborator

@mjbvz mjbvz commented Mar 3, 2026

No description provided.

@mjbvz mjbvz self-assigned this Mar 3, 2026
Copilot AI review requested due to automatic review settings March 3, 2026 19:45
@mjbvz mjbvz enabled auto-merge March 3, 2026 19:45
@vs-code-engineering vs-code-engineering bot added this to the 1.111.0 milestone Mar 3, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds a new top-level contributing guide under extensions/ to briefly document the expected structure of built-in extensions and the basic steps for making an extension web-enabled.

Changes:

  • Introduces extensions/CONTRIBUTING.md with a “typical” built-in extension folder layout.
  • Documents expected build outputs (out vs dist).
  • Adds a short checklist for enabling browser/web support (browser entry, tsconfig.browser.json, esbuild.browser.mts).
Comments suppressed due to low confidence (1)

extensions/CONTRIBUTING.md:18

  • The stated output structure (out for dev, dist for production) isn’t universal across built-in extensions (e.g. declarative extensions don’t have either). Consider clarifying that this applies to TypeScript-based extensions built via the gulp/esbuild pipelines, and optionally mention how main/browser typically map to out/dist.
Extensions have the following output structure:

- `out`: Output directory for development builds
- `dist`: Output directory for production builds.

Comment thread extensions/CONTRIBUTING.md Outdated
Comment thread extensions/CONTRIBUTING.md Outdated
Comment thread extensions/CONTRIBUTING.md Outdated
Comment thread extensions/CONTRIBUTING.md Outdated
mjbvz and others added 4 commits March 3, 2026 11:54
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@mjbvz mjbvz merged commit 23ecafe into microsoft:main Mar 3, 2026
18 checks passed
@vs-code-engineering vs-code-engineering bot locked and limited conversation to collaborators Apr 17, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants