Skip to content

docs: align copy and product names with Microsoft style guide - #84

Merged
DevSecNinja merged 2 commits into
mainfrom
docs/style-guide-alignment
Jun 19, 2026
Merged

DevSecNinja merged 2 commits into
mainfrom
docs/style-guide-alignment

Conversation

@DevSecNinja

@DevSecNinja DevSecNinja commented Jun 19, 2026 •

Copy link
Copy Markdown
Owner

Aligns user-facing text with the Microsoft Writing Style Guide (closes #23).

Changes

Product-name normalisation (src/data/grip.json) — use the official full brand names on first mention:

  • Defender for Endpoint — Device inventory → Microsoft Defender for Endpoint — Device inventory
  • Defender for Cloud Apps — App discovery → Microsoft Defender for Cloud Apps — App discovery
  • Defender for Endpoint Plan 2 (EDR) → Microsoft Defender for Endpoint Plan 2 (EDR)
  • Defender SmartScreen / Web content filtering → Microsoft Defender SmartScreen / Web content filtering
  • Privileged Identity Management (PIM) → Microsoft Entra Privileged Identity Management (PIM) (×2)
  • Conditional Access → Microsoft Entra Conditional Access (×2)
  • Attack Simulation Training (Defender for Office 365) → Attack Simulation Training (Microsoft Defender for Office 365) (×6, O10.1–O10.6)

Licence-spelling consistency (src/i18n/strings.js) — make the English noun consistently British/EU (licence), matching the existing wording elsewhere in the UI:

  • License → Licence
  • M365 Maps: license comparison → …licence comparison
  • AI disclaimer license requirements → licence requirements

The verb/adjective forms (licensed, licensing) and the MIT License proper noun are left unchanged. GRIP-specified wording is untouched.

Test (src/App.test.jsx) — updated the O7 detail-panel assertion to the normalised Microsoft Entra Conditional Access name.

Validation

  • npm run lint — passes
  • npm test — 61 tests pass
  • node -e JSON.parse(...) — grip.json valid; no bare product names remain

Closes #23

Normalise Microsoft product names to their official full forms in
grip.json (Microsoft Defender for Endpoint/Cloud Apps/Office 365,
Microsoft Defender SmartScreen, Microsoft Entra Conditional Access and
Privileged Identity Management) and make the noun 'licence' consistent
across the English UI strings.

Closes #23
@github-actions

github-actions Bot commented Jun 19, 2026 •

Copy link
Copy Markdown
Contributor

🔍 Preview deployed: https://f61958b9.grip-visualizer.pages.dev

Updated: Fri, 19 Jun 2026 13:02:34 GMT

- Add the live site link (grip.ravensberg.org) and a Matrix-view
  screenshot to the README.
- Remove the webinar/Microsoft Elevate framing from the README intro
  and disclaimer.
- Let the footer disclaimer text span the full width.
- Update the E2E assertion to the normalised Microsoft Entra
  Conditional Access product name.
@DevSecNinja
DevSecNinja merged commit 1662984 into main Jun 19, 2026
23 checks passed
@DevSecNinja
DevSecNinja deleted the docs/style-guide-alignment branch June 19, 2026 13:02
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.

docs: align text with the Microsoft Writing Style Guide

1 participant