Skip to content

Conversation

keith-oak
Copy link

Summary

This PR adds three comprehensive instruction files aligned with Microsoft's Responsible AI principles to promote trustworthy AI development practices.

New Files

  1. responsible-ai-development.instructions.md - Core framework implementing Microsoft's six Responsible AI principles:

    • Fairness: AI systems should treat all people fairly
    • Reliability and Safety: AI systems should perform reliably and safely
    • Privacy and Security: AI systems should be secure and respect privacy
    • Inclusiveness: AI systems should empower everyone
    • Transparency: AI systems should be understandable
    • Accountability: People should be accountable for AI systems
  2. human-in-the-loop-development.instructions.md - Best practices for maintaining human oversight, validation, and decision-making in AI-assisted development workflows

  3. inclusive-language-bias-awareness.instructions.md - Comprehensive guidelines for using inclusive, bias-aware language in code, documentation, and all technical artifacts

Updated Files

  • CONTRIBUTING.md - Updated to emphasize Responsible AI development practices aligned with Microsoft's framework
  • README.instructions.md - Automatically updated via npm run build to include the new instruction files

Key Features

  • ✅ Aligned with Microsoft's Responsible AI principles
  • ✅ Practical examples and checklists for each principle
  • ✅ Development workflow integration guidance
  • ✅ Comprehensive code examples in JavaScript/TypeScript
  • ✅ Links to official Microsoft Responsible AI resources and tools
  • ✅ Applies to all files (applyTo: '**')
  • ✅ Tested with GitHub Copilot

Why This Matters

These instructions help developers:

  • Keep humans in control while using AI assistance
  • Build fair, secure, and inclusive AI-powered applications
  • Follow industry best practices for AI development
  • Uphold Microsoft's commitment to Responsible AI

Checklist

  • Files follow naming conventions (lowercase-with-hyphens)
  • Frontmatter includes required fields (description, applyTo)
  • Description in single quotes and non-empty
  • Ran npm run build to update README files
  • Tested instructions with GitHub Copilot
  • Uses inclusive language throughout
  • Aligns with Microsoft Responsible AI principles

Testing

All instruction files have been tested with GitHub Copilot to ensure they provide effective guidance for AI-assisted development while promoting responsible practices.

Added three new instruction files aligned with Microsoft's Responsible AI principles:

- responsible-ai-development.instructions.md: Comprehensive guide implementing Microsoft's six Responsible AI principles (Fairness, Reliability & Safety, Privacy & Security, Inclusiveness, Transparency, Accountability)
- human-in-the-loop-development.instructions.md: Best practices for maintaining human oversight and accountability in AI-assisted development workflows
- inclusive-language-bias-awareness.instructions.md: Guidelines for using inclusive, bias-aware language across all technical artifacts

Updated CONTRIBUTING.md to emphasize Responsible AI development practices and align with Microsoft's official framework.

These files promote trustworthy AI development that upholds societal values while enhancing developer productivity with AI tools like GitHub Copilot.
@Copilot Copilot AI review requested due to automatic review settings October 6, 2025 10:40
Copy link
Contributor

@Copilot 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

This PR adds comprehensive Responsible AI development guidance aligned with Microsoft's six principles (Fairness, Reliability & Safety, Privacy & Security, Inclusiveness, Transparency, and Accountability) to enhance AI-assisted development practices.

Key additions include:

  • Three new instruction files implementing Microsoft's Responsible AI framework
  • Human-in-the-loop practices emphasizing developer oversight and validation
  • Inclusive language guidelines for bias-aware technical communication

Reviewed Changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
responsible-ai-development.instructions.md Core framework implementing Microsoft's six Responsible AI principles with practical examples and checklists
inclusive-language-bias-awareness.instructions.md Comprehensive guidelines for using inclusive, bias-aware language in all technical artifacts
human-in-the-loop-development.instructions.md Best practices for maintaining human oversight and decision-making in AI-assisted workflows
README.instructions.md Auto-generated updates adding the new instruction files to the documentation
CONTRIBUTING.md Updated to emphasize Responsible AI development practices and Microsoft's framework

Copy link
Contributor

@aaronpowell aaronpowell left a comment

Choose a reason for hiding this comment

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

Could you revert the changes to the CONTRIBUTING.md file as those kinds of changes are something I'd prefer to discuss where we have gaps in our current guidance and adapt rather than bring in directly.

@jeremiah-snee-openx
Copy link
Contributor

jeremiah-snee-openx commented Oct 8, 2025

Could you revert the changes to the CONTRIBUTING.md file as those kinds of changes are something I'd prefer to discuss where we have gaps in our current guidance and adapt rather than bring in directly.

@aaronpowell Usage?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants