Skip to content

docs: align Transparency Note with AI Messaging Guidance#2020

Merged
WilliamBerryiii merged 1 commit into
docs/transparency-notefrom
docs/transparency-note-ai-messaging
Jun 17, 2026
Merged

docs: align Transparency Note with AI Messaging Guidance#2020
WilliamBerryiii merged 1 commit into
docs/transparency-notefrom
docs/transparency-note-ai-messaging

Conversation

@raymond-nassar

Copy link
Copy Markdown
Collaborator

Description

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

Type of Change

Code & Documentation:

  • Documentation update

Testing

Targeted local validation on TRANSPARENCY-NOTE.md:

  • markdownlint-cli2: pass
  • cspell: pass (0 issues)
  • markdown-link-check: pass (all links resolve, including the added AI Principles link)

Checklist

Required Checks

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

Required Automated Checks

  • Markdown linting: npm run lint:md
  • Spell checking: npm run spell-check
  • Link validation: npm run lint:md-links

Security Considerations

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

- 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 requested a review from a team as a code owner June 16, 2026 20:52
@raymond-nassar raymond-nassar added the documentation Improvements or additions to documentation label Jun 16, 2026
@WilliamBerryiii WilliamBerryiii merged commit 0faa6ab into docs/transparency-note Jun 17, 2026
1 check passed
WilliamBerryiii pushed a commit that referenced this pull request Jun 17, 2026
## 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:**

* [x] 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 #2020 patch.

## Checklist

### Required Checks

* [x] Documentation is updated (if applicable)
* [x] Files follow existing naming conventions
* [x] Changes are backwards compatible (if applicable)

### Required Automated Checks

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

## Security Considerations

* [x] This PR does not contain any sensitive or NDA information
* [x] No new dependencies
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants