Skip to content

WIP: NDC Release 5.7.12 Documentation Update - #1505

Open
BenHayman-Netwrix wants to merge 7 commits into
devfrom
NDC/release-5.7.12
Open

WIP: NDC Release 5.7.12 Documentation Update#1505
BenHayman-Netwrix wants to merge 7 commits into
devfrom
NDC/release-5.7.12

Conversation

@BenHayman-Netwrix

Copy link
Copy Markdown
Contributor

No description provided.

@github-actions

github-actions Bot commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

Auto-Fix Summary

72 issues fixed, 6 skipped across 6 files

Category Fixes
Contractions 3
Substitutions 6
AllowsYouTo (rewrite) 2
CanBeUsedTo (rewrite) 2
FollowTheStepsTo (rewrite) 2
OxfordComma (rewrite) 1
Dale: exclamatory-sentences 1
Dale: passive-voice 38
Dale: undefined-acronyms 1
Dale: wordiness 16
Skipped (needs manual review) Reason

| docs/dataclassification/5.7/contentconfigurationoverview/introduction/addsource/exchangemailboxews.md:44 — Dale: positional-references | "in the bottom" refers to a physical UI location in the properties window, not to other content on the page |
| docs/dataclassification/5.7/contentconfigurationoverview/introduction/addsource/exchangeserverews.md:29 — Dale: positional-references | "bottom-left corner" refers to a physical UI location, not to other content on the page |
| docs/dataclassification/5.7/contentconfigurationoverview/introduction/addsource/exchangemailboxews.md:50 — Dale: wordiness | "Select Since if you want to periodically re-crawl content" — "if you want to" is the established conditional-option phrasing used consistently across all source tables; rewording one instance would break consistency |
| docs/dataclassification/5.7/contentconfigurationoverview/introduction/addsource/sharepointonline.md:16 — Dale: wordiness | "Templating allows an administrator to preconfigure" — multiple valid rewrites and the sentence is already direct; left to the author |
| docs/dataclassification/5.7/contentconfigurationoverview/introduction/addsource/sharepointonline.md:18 — Dale: positional-references | "review the associated templating guide" has no target link; adding or resolving one would require content the page doesn't provide |
| docs/dataclassification/5.7/introduction/upgrade.md:57 — Dale: wordiness | "you should run the installer as the NDC service account if possible" — the hedging is deliberate guidance; tightening it would change the strength of the recommendation |

Ask @claude on this PR if you'd like an explanation of any fix.

@github-actions

github-actions Bot commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

Auto-Fix Summary

9 issues fixed, 7 skipped across 6 files

Category Fixes
Contractions 1
Substitutions 1
Dale: misplaced-modifiers 2
Dale: passive-voice 3
Dale: wordiness 2
Skipped (needs manual review) Reason

| docs/dataclassification/5.7/contentconfigurationoverview/introduction/addsource/exchangemailboxews.md:26 — Dale: misplaced-modifiers | 'The user must have a mailbox connected to it to crawl Exchange.' — the trailing infinitive is ambiguous (whether the user or the product crawls Exchange); rewriting could change the technical meaning |
| docs/dataclassification/5.7/contentconfigurationoverview/introduction/addsource/exchangemailboxews.md:9 — Dale: passive-voice | 'content stored in a single Exchange mailbox' is a reduced relative clause used consistently across all five source topics; rewriting would diverge from sibling pages without improving clarity |
| docs/dataclassification/5.7/contentconfigurationoverview/introduction/addsource/exchangemailboxgraph.md:18 — Dale: passive-voice | heading text — not modified to avoid breaking anchor links |
| docs/dataclassification/5.7/contentconfigurationoverview/introduction/addsource/exchangeserverews.md:10 — Dale: misplaced-modifiers | 'multiple Exchange mailboxes from the same Exchange server using the Exchange Web Services (EWS)' — 'using' could attach to the crawl action or to the server; the intended attachment is clear enough from context and any rewrite risks changing the technical claim |
| docs/dataclassification/5.7/contentconfigurationoverview/introduction/addsource/sharepointonline.md:9 — Dale: passive-voice | 'SharePoint Online sites hosted in Office 365' is a reduced relative clause reading naturally as an adjective phrase; rewriting adds words without improving clarity |
| docs/dataclassification/5.7/introduction/upgrade.md:42 — Dale: wordiness | This second 'Step 4 -' block duplicates Step 3 and the following warning, and its step number collides with the Index-files Step 4 above it. Removing or renumbering it is a content/structure decision for the author, not a style fix |
| docs/dataclassification/5.7/introduction/upgrade.md:52 — Dale: wordiness | 'After taking the preceding preparatory steps' is mildly redundant, but trimming it risks losing the deliberate back-reference to the prerequisites section |

Ask @claude on this PR if you'd like an explanation of any fix.

@github-actions

Copy link
Copy Markdown
Contributor

Auto-Fix Summary

16 issues fixed, 6 skipped across 8 files

Category Fixes
Substitutions 2
FirstPersonPlural (rewrite) 1
Dale: misplaced-modifiers 4
Dale: passive-voice 4
Dale: wordiness 5
Skipped (needs manual review) Reason

| docs/dataclassification/5.7/contentconfigurationoverview/introduction/addsource/exchangemailboxgraph.md:9 — Dale: wordiness | Sentence 'For on-premises Exchange mailboxes, Exchange Mailbox (EWS).' is missing its verb. The intended verb is ambiguous (use / see / configure), so a rewrite could change meaning — needs author input rather than a Dale fix |
| docs/dataclassification/5.7/contentconfigurationoverview/introduction/addsource/exchangemailboxews.md:11 — Dale: wordiness | 'Due to the imminent deprecation of EWS for connecting to Exchange Online' is wordy, but every concise rewrite either drops 'imminent' or adds a claim about Microsoft's timeline that the source doesn't make |
| docs/dataclassification/5.7/contentconfigurationoverview/introduction/addsource/exchangemailboxews.md:52 — Dale: wordiness | 'taking into account the last crawl date for each object' is mildly wordy; tightening it risks losing the precise re-crawl semantics being described |
| docs/dataclassification/5.7/introduction/introduction/exchange/exchange.md:9 — Dale: misplaced-modifiers | 'When preparing your Exchange Server for data classification:' is an incomplete lead-in with no main clause. Cannot determine the intended subject and predicate from context |
| docs/dataclassification/5.7/introduction/introduction/exchange/exchange.md:49 — Dale: wordiness | 'Add your user as a member and/or assign your user for Modern Authentication set up to this Role as well' is unclear; multiple valid interpretations of what should be assigned |
| docs/dataclassification/5.7/contentconfigurationoverview/introduction/addsource/sharepointonline.md:16 — Dale: wordiness | 'Templating allows an administrator to preconfigure classification settings' uses the 'allows ... to' construction, which Vale handles rather than Dale; no Dale rule violation confirmed |

Ask @claude on this PR if you'd like an explanation of any fix.

@jth-nw
jth-nw deployed to development September 11, 2026 14:13 — with GitHub Actions Active
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.

2 participants