github / github/docs

Clarify and consolidate documentation for content exclusions for the different GitHub Copilot modes

Aberta
#42,617 9 comentários 0 reações 0 responsáveis Ver no GitHub
content copilot needs SME Waiting on SME review
Linguagem predominante
TypeScript
Estrelas
20.8k
Forks
68.7k
Merge médio
13h 10min
PRs com merge (30d)
111

Descrição

### Code of Conduct

- [x] I have read and agree to the GitHub Docs project's [Code of Conduct](https://github.com/github/docs/blob/main/.github/CODE_OF_CONDUCT.md)

### What article on docs.github.com is affected?

https://docs.github.com/en/copilot/how-tos/configure-content-exclusion/exclude-content-from-copilot#configuring-content-exclusion-for-your-repository (accessed on 29th January 2026)
https://docs.github.com/en/copilot/concepts/context/content-exclusion#availability-of-content-exclusion (accessed on 29th January 2026)

### What part(s) of the article would you like to see updated?

## Problem Description

The current documentation around GitHub Copilot content exclusion appears to be inconsistent and, in some cases, contradictory across different official sources. This makes it difficult to understand which Copilot tools and modes actually respect content exclusion rules.

## Conflicting Documentation

### Configure content exclusion (GitHub Docs)
https://docs.github.com/en/copilot/how-tos/configure-content-exclusion/exclude-content-from-copilot#configuring-content-exclusion-for-your-repository

This page states that **GitHub Copilot CLI, Copilot coding agent, and Agent mode in Copilot Chat** in IDEs do **not support content exclusion**, and refers to additional documentation for clarification.

### Content exclusion concepts and availability (GitHub Docs)
https://docs.github.com/en/copilot/concepts/context/content-exclusion#availability-of-content-exclusion

This page indicates that content exclusion is available in Copilot Chat for Visual Studio Code, but includes the following note:
- Content exclusion is in public preview on the GitHub website and GitHub Mobile.
- Content exclusion is **currently not supported in Edit and Agent modes of Copilot Chat in Visual Studio Code** and other editors.

### Copilot Agent Mode (Microsoft Learn)
https://learn.microsoft.com/en-us/visualstudio/ide/copilot-agent-mode?view=visualstudio#frequently-asked-questions

This documentation states that **Agent mode cannot access files and directories excluded through file exclusion**, which suggests that content exclusion is respected by Agent mode, at least in Visual Studio.

## Observed Behavior

When testing a simple scenario, content exclusion appeared to work across all Copilot modes, including those documented as unsupported. This may indicate:
- Partial or implicit support depending on the tool or environment
- Differences between file exclusion and content exclusion
- Outdated or incomplete documentation

For the testing scenario we added an GitLab Repository for the content exclusion in the GitHub Copilot Business content exclusion setting and tested for the ask, edit and agent mode in the VS Code Chat if the file can be explained. For all the modes the response said that no context was attached even when i manually drag and dropped the file into the chat window.

## Requested Improvement

The documentation should be updated to clearly and explicitly describe:
- Which Copilot tools and modes support content exclusion
- Which modes do not support it, and in what way
- Whether behavior differs between:
- Chat, Edit, and Agent modes
- IDEs (VS Code, Visual Studio) and the GitHub website
- Any known limitations, caveats, or indirect behaviors that may cause content exclusion to appear to work even when it is not fully supported

A concise support matrix or table outlining Copilot mode vs. content exclusion behavior would greatly improve clarity and help users avoid incorrect assumptions.

Clear and accurate documentation is particularly important for business and enterprise users, as content exclusion is often a critical compliance and data-protection requirement. Organizations need to clearly understand which Copilot modes and tools can be safely used while content exclusion is enabled, and which modes may bypass or partially ignore these rules. Without this clarity, there is a risk of unintentional exposure of sensitive or proprietary information and uncertainty about whether Copilot usage complies with internal policies and regulatory obligations.

### Related Issues and Pull Requests
- **GitHub Docs issue:** https://github.com/github/docs/issues/40951
- **GitHub Docs pull request (closed):** https://github.com/github/docs/pull/40952
- **VS Code issue:** https://github.com/microsoft/vscode/issues/278829
- **VS Code Copilot release issue:** https://github.com/microsoft/vscode-copilot-release/issues/12711

### Additional information

_No response_

Guia de contribuição

Abrir o guia de contribuição

Direção de pesquisa

Comece comparando as duas páginas do GitHub Docs vinculadas na issue e, em seguida, analise a issue relacionada 40951 e o pull request fechado 40952 junto com as discussões referenciadas do VS Code. Confirme os modos e ambientes compatíveis com os maintainers antes de consolidar as informações em uma matriz de suporte; considera-se concluído quando a documentação resolve as contradições e declara claramente as limitações.

Escrita pelo modelo de indexação a partir do texto da issue.

Avaliação

Stack de tecnologia
github
Domínio
documentation
Tipo de issue
Documentação
Dificuldade
4/5
Tempo estimado
3-5 dias
Status de atividade
Ativa
Clareza
Razoavelmente clara
Facilidade para iniciantes
38/100

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.