Repository navigation
Add disallowed Features page - #756
Merged
Merged
Conversation
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Christof Marti (chrmarti)
requested review from
Brigit Murtaugh (bamurtaugh)
and
a balanced review from Copilot
November 20, 2026 09:03
Contributor
There was a problem hiding this comment.
🟡 Changes recommended
The documentation misdirects third-party abuse reports, links to an inaccessible repository, and incorrectly implies that a rejected standalone build stops a running container.
3 open issues
What changed in this PR
Adds a tool-neutral help page at /disallowed-features for users directed there by dev container errors, including cases involving renamed or deleted publisher accounts.
Changes:
- Explains why Features are disallowed and how users can remove or replace them.
- Provides guidance for Feature authors and reporting problematic Features.
- Documents the control manifest’s matching rules and documentation links.
| File | Description |
|---|---|
disallowed-features.md |
Adds the disallowed Features help page with remediation guidance and control-manifest documentation. |
Review effort: Balanced
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Christof Marti (chrmarti)
marked this pull request as ready for review
November 20, 2026 09:13
Brigit Murtaugh (bamurtaugh)
approved these changes
Nov 20, 2026
1 of 4 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.

Summary
Adds a containers.dev page at
/disallowed-featuresthat explains why dev container tools refuse to use a Feature listed in the control manifest'sdisallowedFeatures, and what users and Feature authors should do about it. Control manifest entries can link to it from theirdocumentationURL, which the dev container CLI appends to its error and the Dev Containers extension shows as a Learn More button.Session Context
Key decisions from the development session:
learnMoreUrlalso show up in the plain dev container CLI, Codespaces and other spec-implementing tools, so the page is tool-neutral. The VS Code-specificdev.containers.defaultFeaturessetting is mentioned only as an example.https://aka.ms/dev-container-disallowed-features, to be redirected to this page once it is live, so the target can move without updating the manifest.supporting.md(singlePagelayout, anchored headings). It is reached from the error link, so it isn't added to the top nav.src/spec-node/disallowedFeatures.ts). A running container is only stopped when opening or starting a dev container, not on a standalonedevcontainer build.featureIdPrefixdescription matches the CLI's matcher: the prefix must equal the ID or be followed by/,:or@, and it is case-sensitive.SECURITY.mdonly covers Microsoft-owned repositories, and the control manifest's source repository isn't public, so neither is linked.ghcr.io/actions/jekyll-build-pages); the page renders and all relative links resolve.Changes
disallowed-features.md: new page covering the error users see, why a Feature can be disallowed, what to do, guidance for Feature authors, how to report a problematic Feature, and thedisallowedFeaturesentry format.