Skip to content

[docs] Reword terms flagged by PoliCheck#11961

Merged
simonrozsival merged 1 commit into
mainfrom
jonathanpeppers-fix-policheck-java-interop
Jul 3, 2026
Merged

[docs] Reword terms flagged by PoliCheck#11961
simonrozsival merged 1 commit into
mainfrom
jonathanpeppers-fix-policheck-java-interop

Conversation

@jonathanpeppers

Copy link
Copy Markdown
Member

After merging Java.Interop into this repo, its docs are now scanned under dotnet/android's PoliCheck rules for the first time, which surfaced three flagged terms. These are prose-only hits, so rewording is the cleanest fix (it's also the outcome PoliCheck itself recommends for "blacklist") and avoids adding suppression signatures for documentation text.

Changes:

  • external/Java.Interop/Documentation/Architecture.md: "ball of mud" -> "tangled mess"
  • external/Java.Interop/Documentation/EnumMappingFile.md: "blacklists" -> "block lists"

This clears all three active PoliCheck results (both blacklist/blacklists hits were on the same line).

Reword two phrases in merged Java.Interop docs that PoliCheck flagged:

- Architecture.md: 'ball of mud' -> 'tangled mess'

- EnumMappingFile.md: 'blacklists' -> 'block lists'

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings July 2, 2026 21:15

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Updates Java.Interop documentation wording to address terms flagged by dotnet/android’s PoliCheck rules after the merge, keeping the changes prose-only to avoid suppression signatures.

Changes:

  • Reword “ball of mud” → “tangled mess” in Java.Interop architecture documentation.
  • Reword “blacklists” → “block lists” in enum mapping format documentation.

Reviewed changes

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

File Description
external/Java.Interop/Documentation/EnumMappingFile.md Rewords a flagged term in the enum mapping format discussion.
external/Java.Interop/Documentation/Architecture.md Rewords a flagged phrase in the architecture critique section.

@simonrozsival simonrozsival merged commit f2f2a38 into main Jul 3, 2026
43 checks passed
@simonrozsival simonrozsival deleted the jonathanpeppers-fix-policheck-java-interop branch July 3, 2026 06:53
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