Skip to content

docs: align Transparency Note with AI Messaging Guidance#2039

Merged
WilliamBerryiii merged 1 commit into
mainfrom
docs/repair-markdown-link-targets-main
Jun 17, 2026
Merged

docs: align Transparency Note with AI Messaging Guidance#2039
WilliamBerryiii merged 1 commit into
mainfrom
docs/repair-markdown-link-targets-main

Conversation

@raymond-nassar

@raymond-nassar raymond-nassar commented Jun 17, 2026

Copy link
Copy Markdown
Collaborator

Description

Ports the approved PR #2020 Transparency Note update to main. PR #2020 merged into docs/transparency-note, so the approved file changes did not reach the default branch.

Aligns the HVE Core Transparency Note with the AI Messaging Guidance. Four prose edits:

  • adds a limitation that outputs inherit the host model's properties (can fail, not neutral, not bias-free)
  • describes agents and prompts by capability instead of productivity claims
  • enumerates Microsoft's six AI principles
  • softens "the right" to "appropriate" Responsible AI controls

File scope: TRANSPARENCY-NOTE.md only.

Type of Change

Code & Documentation:

  • Documentation update

Testing

Targeted local validation on TRANSPARENCY-NOTE.md:

  • npx markdownlint-cli2 TRANSPARENCY-NOTE.md: pass
  • npx cspell TRANSPARENCY-NOTE.md: pass, 0 issues
  • git diff --check origin/main..HEAD: pass
  • & .\scripts\linting\Markdown-Link-Check.ps1 -Path @('TRANSPARENCY-NOTE.md'): passed once before push; later reruns returned HTTP 403 from Microsoft pages (https://www.microsoft.com/ai/responsible-ai and https://www.microsoft.com/ai/tools-practices). The file diff remains unchanged because it intentionally mirrors the approved PR docs: align Transparency Note with AI Messaging Guidance #2020 patch.

Checklist

Required Checks

  • Documentation is updated (if applicable)
  • Files follow existing naming conventions
  • Changes are backwards compatible (if applicable)

Required Automated Checks

  • Targeted Markdown linting: npx markdownlint-cli2 TRANSPARENCY-NOTE.md
  • Targeted spell checking: npx cspell TRANSPARENCY-NOTE.md
  • Whitespace validation: git diff --check origin/main..HEAD
  • Link validation: intermittent external 403s from Microsoft pages, see Testing

Security Considerations

  • This PR does not contain any sensitive or NDA information
  • No new dependencies

@raymond-nassar raymond-nassar requested a review from a team as a code owner June 17, 2026 20:41
@codecov-commenter

codecov-commenter commented Jun 17, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 80.82%. Comparing base (a847cfa) to head (9b34e08).
⚠️ Report is 6 commits behind head on main.

Additional details and impacted files

Impacted file tree graph

@@            Coverage Diff             @@
##             main    #2039      +/-   ##
==========================================
- Coverage   80.82%   80.82%   -0.01%     
==========================================
  Files         117      117              
  Lines       19095    19100       +5     
==========================================
+ Hits        15433    15437       +4     
- Misses       3662     3663       +1     
Flag Coverage Δ
pester 84.64% <ø> (-0.01%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.
see 1 file with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

- state AI can fail and is not neutral or bias-free
- describe agents and prompts by capability, not productivity
- list Microsoft's six AI principles
- soften "right" to "appropriate" RAI controls
@raymond-nassar raymond-nassar force-pushed the docs/repair-markdown-link-targets-main branch from d3a30f8 to 9b34e08 Compare June 17, 2026 20:48
@raymond-nassar raymond-nassar changed the title fix(docs): repair markdown link targets docs: align Transparency Note with AI Messaging Guidance Jun 17, 2026
@WilliamBerryiii WilliamBerryiii merged commit 04c9331 into main Jun 17, 2026
67 checks passed
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.

4 participants