From c0eb2c5fe54e69411d077cebd34b1a4a3917ccc7 Mon Sep 17 00:00:00 2001 From: Aaron Powell Date: Wed, 11 Mar 2026 11:19:46 +1100 Subject: [PATCH 1/3] Policy update --- .github/pull_request_template.md | 1 + CONTRIBUTING.md | 72 ++++++++++++++++---------------- 2 files changed, 38 insertions(+), 35 deletions(-) diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 603c306b1..2d4b58f09 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -1,6 +1,7 @@ ## Pull Request Checklist - [ ] I have read and followed the [CONTRIBUTING.md](https://github.com/github/awesome-copilot/blob/main/CONTRIBUTING.md) guidelines. +- [ ] I have read and followed the [Guidance for submissions involving paid services](https://github.com/github/awesome-copilot/discussions/968). - [ ] My contribution adds a new instruction, prompt, agent, skill, or workflow file in the correct directory. - [ ] The file follows the required naming convention. - [ ] The content is clearly structured and follows the example format. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index c3afca499..1572244b1 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -4,6 +4,9 @@ Thank you for your interest in contributing to the Awesome GitHub Copilot reposi ## Table of Contents +- [What We Accept](#what-we-accept) +- [What We Don't Accept](#what-we-dont-accept) +- [Quality Guidelines](#quality-guidelines) - [How to Contribute](#how-to-contribute) - [Adding Instructions](#adding-instructions) - [Adding Prompts](#adding-prompts) @@ -13,14 +16,45 @@ Thank you for your interest in contributing to the Awesome GitHub Copilot reposi - [Adding Hooks](#adding-hooks) - [Adding Agentic Workflows](#adding-agentic-workflows) - [Submitting Your Contribution](#submitting-your-contribution) -- [What We Accept](#what-we-accept) -- [What We Don't Accept](#what-we-dont-accept) -- [Quality Guidelines](#quality-guidelines) - [Contributor Recognition](#contributor-recognition) - [Contribution Types](#contribution-types) - [Code of Conduct](#code-of-conduct) - [License](#license) +## What We Accept + +We welcome contributions covering any technology, framework, or development practice that helps developers work more effectively with GitHub Copilot. This includes: + +- Programming languages and frameworks +- Development methodologies and best practices +- Architecture patterns and design principles +- Testing strategies and quality assurance +- DevOps and deployment practices +- Accessibility and inclusive design +- Performance optimization techniques + +If you are planning to contribute content that involves paid services, please review our [Guidance for submissions involving paid services](https://github.com/github/awesome-copilot/discussions/968). + +## What We Don't Accept + +To maintain a safe, responsible, and constructive community, we will **not accept** contributions that: + +- **Violate Responsible AI Principles**: Content that attempts to circumvent Microsoft/GitHub's Responsible AI guidelines or promotes harmful AI usage +- **Compromise Security**: Instructions designed to bypass security policies, exploit vulnerabilities, or weaken system security +- **Enable Malicious Activities**: Content intended to harm other systems, users, or organizations +- **Exploit Weaknesses**: Instructions that take advantage of vulnerabilities in other platforms or services +- **Promote Harmful Content**: Guidance that could lead to the creation of harmful, discriminatory, or inappropriate content +- **Circumvent Platform Policies**: Attempts to work around GitHub, Microsoft, or other platform terms of service + +## Quality Guidelines + +- **Be specific**: Generic instructions are less helpful than specific, actionable guidance +- **Test your content**: Ensure your instructions or skills work well with GitHub Copilot +- **Follow conventions**: Use consistent formatting and naming +- **Keep it focused**: Each file should address a specific technology, framework, or use case +- **Write clearly**: Use simple, direct language +- **Promote best practices**: Encourage secure, maintainable, and ethical development practices + ## How to Contribute ### Adding Instructions @@ -288,38 +322,6 @@ Create a daily summary of open issues for the team. > [!NOTE] > We use [all-contributors](https://github.com/all-contributors/all-contributors) to recognize all types of contributions to the project. Jump to [Contributors Recognition](#contributor-recognition) to learn more! -## What We Accept - -We welcome contributions covering any technology, framework, or development practice that helps developers work more effectively with GitHub Copilot. This includes: - -- Programming languages and frameworks -- Development methodologies and best practices -- Architecture patterns and design principles -- Testing strategies and quality assurance -- DevOps and deployment practices -- Accessibility and inclusive design -- Performance optimization techniques - -## What We Don't Accept - -To maintain a safe, responsible, and constructive community, we will **not accept** contributions that: - -- **Violate Responsible AI Principles**: Content that attempts to circumvent Microsoft/GitHub's Responsible AI guidelines or promotes harmful AI usage -- **Compromise Security**: Instructions designed to bypass security policies, exploit vulnerabilities, or weaken system security -- **Enable Malicious Activities**: Content intended to harm other systems, users, or organizations -- **Exploit Weaknesses**: Instructions that take advantage of vulnerabilities in other platforms or services -- **Promote Harmful Content**: Guidance that could lead to the creation of harmful, discriminatory, or inappropriate content -- **Circumvent Platform Policies**: Attempts to work around GitHub, Microsoft, or other platform terms of service - -## Quality Guidelines - -- **Be specific**: Generic instructions are less helpful than specific, actionable guidance -- **Test your content**: Ensure your instructions or skills work well with GitHub Copilot -- **Follow conventions**: Use consistent formatting and naming -- **Keep it focused**: Each file should address a specific technology, framework, or use case -- **Write clearly**: Use simple, direct language -- **Promote best practices**: Encourage secure, maintainable, and ethical development practices - ## Contributor Recognition We use [all-contributors](https://github.com/all-contributors/all-contributors) to recognize **all types of contributions** to this project. From 10f8ebe47979eb48ef876ea7204d7233d10f3406 Mon Sep 17 00:00:00 2001 From: Aaron Powell Date: Wed, 11 Mar 2026 11:49:32 +1100 Subject: [PATCH 2/3] Adding guidance on not accepting contributions that lower frontier model capabilities --- CONTRIBUTING.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 1572244b1..0d44424ec 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -37,7 +37,7 @@ If you are planning to contribute content that involves paid services, please re ## What We Don't Accept -To maintain a safe, responsible, and constructive community, we will **not accept** contributions that: +To maintain a safe, responsible, and high-signal collection, we will **not accept** contributions that: - **Violate Responsible AI Principles**: Content that attempts to circumvent Microsoft/GitHub's Responsible AI guidelines or promotes harmful AI usage - **Compromise Security**: Instructions designed to bypass security policies, exploit vulnerabilities, or weaken system security @@ -45,6 +45,9 @@ To maintain a safe, responsible, and constructive community, we will **not accep - **Exploit Weaknesses**: Instructions that take advantage of vulnerabilities in other platforms or services - **Promote Harmful Content**: Guidance that could lead to the creation of harmful, discriminatory, or inappropriate content - **Circumvent Platform Policies**: Attempts to work around GitHub, Microsoft, or other platform terms of service +- **Duplicate Existing Model Strengths Without Meaningful Uplift**: Submissions that mainly tell Copilot to do work frontier models already handle well (for example, generic TypeScript, HTML, or other broadly-supported coding tasks) without addressing a clear gap, specialized workflow, or domain-specific constraint. These contributions are often lower value for users and can introduce weaker or conflicting guidance than the model's default behavior. + +If your contribution targets an area where models are already strong, be explicit about the gap it closes and the measurable value it adds beyond the default experience. ## Quality Guidelines From 933dd63495683e69175b6e19e8fc35589665e392 Mon Sep 17 00:00:00 2001 From: Aaron Powell Date: Wed, 11 Mar 2026 14:07:34 +1100 Subject: [PATCH 3/3] Remote plugin source policy --- CONTRIBUTING.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 0d44424ec..dc938c2a3 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -46,8 +46,7 @@ To maintain a safe, responsible, and high-signal collection, we will **not accep - **Promote Harmful Content**: Guidance that could lead to the creation of harmful, discriminatory, or inappropriate content - **Circumvent Platform Policies**: Attempts to work around GitHub, Microsoft, or other platform terms of service - **Duplicate Existing Model Strengths Without Meaningful Uplift**: Submissions that mainly tell Copilot to do work frontier models already handle well (for example, generic TypeScript, HTML, or other broadly-supported coding tasks) without addressing a clear gap, specialized workflow, or domain-specific constraint. These contributions are often lower value for users and can introduce weaker or conflicting guidance than the model's default behavior. - -If your contribution targets an area where models are already strong, be explicit about the gap it closes and the measurable value it adds beyond the default experience. +- **Plugins from remote sources**: While the plugin design allows us to support plugins from other GitHub repos, or other Git endpoints, we are not accepting contributions that simply add plugins from external sources. Plugins from remote sources represent a security risk as we are unable to verify their content for the policies we enforce on this repository. This policy does not apply to repositories that are managed by Microsoft or GitHub. ## Quality Guidelines