Skip to content

Strengthen contributor guidance to support Help-Wanted contributions - #6402

Draft
Trenly wants to merge 6 commits into
microsoft:masterfrom
Trenly:ContributorDocs
Draft

Strengthen contributor guidance to support Help-Wanted contributions#6402
Trenly wants to merge 6 commits into
microsoft:masterfrom
Trenly:ContributorDocs

Conversation

@Trenly

@Trenly Trenly commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

📖 Description

Strengthens contributor guidance to better support Help-Wanted contributions. Addresses the four sub-issues tracked under #6393:

  • Adds an explicit testing policy to CONTRIBUTING.md specifying when unit and E2E tests are expected, when they may be omitted, and how to run them.
  • Adds doc/Standards.md, a new coding conventions reference covering file formatting, brace style, naming (C++ and C#), error handling (WIL/AICLI_* macros), casts, std::move() usage, and resource string requirements.
  • Adds an AI-assisted contributions policy to CONTRIBUTING.md clarifying that contributors are fully accountable for AI-generated code and must disclose material AI use in their PR.
  • Updates .github/PULL_REQUEST_TEMPLATE.md to add an evidence prompt in the Validation section, a tests checkbox, and an AI Assistance disclosure section.
  • Updates doc/Developing.md to cross-reference doc/Standards.md and add a dedicated "Running End-to-End Tests" section.
  • Updates .github/copilot-instructions.md to document PR expectations for AI-assisted work and normalize trailing whitespace.

cc @denelon

🔗 References

🔍 Validation

Documentation-only changes. All cross-references and Markdown anchor links verified. No functional code changed.

✅ Checklist

🤖 AI Assistance

  • AI assistance was used and has been disclosed in this PR

GitHub Copilot assisted in authoring all documentation additions in this PR: the new doc/Standards.md file, the AI-assisted contributions policy, the expanded testing guidance in CONTRIBUTING.md, the "Running End-to-End Tests" section in doc/Developing.md, and the PR template updates. I have reviewed and revised the submitted content.

📋 Issue Type

  • Bug fix
  • Feature
  • Task
Microsoft Reviewers: Open in CodeFlow

Trenly and others added 5 commits July 28, 2026 20:31
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* Add screenshot/recording evidence prompt to Validation section
* Add 'AI assistance was used and has been disclosed' checkbox
* Add 'No AI assistance was used' checkbox
* Add 'Added or updated tests (or noted why not applicable)' checkbox

Resolves microsoft#6397

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
There may be pipelines that require an authorized user to comment /azp run to run.

@github-actions

This comment has been minimized.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant