Skip to content

Add Change Tracker KB batch 4b - #1268

Merged
hilram7 merged 5 commits into
devfrom
kb/changetracker-batch-4b
Aug 1, 2026
Merged

Add Change Tracker KB batch 4b#1268
hilram7 merged 5 commits into
devfrom
kb/changetracker-batch-4b

Conversation

@hilram7

@hilram7 hilram7 commented Jul 27, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds 5 new Change Tracker KB articles migrated from the staging repo for Denis Goskolli's SME review.

Changes

  • Migrates and updates 5 Change Tracker KB articles across configuration-and-setup, database-and-diagnostics, and troubleshooting-and-errors
  • Retitles a Draft-status placeholder article ("test_value") to a proper rolling-log-fix title matching series conventions
  • Neutralizes unverified factual claims in body/title/description rather than asserting them, flagging each as an SME question
  • Applies Vale/Dale/Derek lint fixes: bolds Command Prompt where opened, corrects passive voice and positional references, fixes a code-fence language mismatch, reorders one Overview to lead with the goal sentence, and converts a precautionary instruction to an IMPORTANT callout
  • Standardizes all SME Review Needed inline flags to a consistent bracketed format

Testing

  • kb-pr-open (Vale + Dale + Derek): 0 Vale errors across all 5 files; Dale (10/10 rules) and Derek (frontmatter, structure, formatting, cross-section) findings resolved
  • Local build: successful, no broken links or anchor errors

SME Review Needed

  1. stop-blocking-ip-address.md
    — The article states lockoutenabled locks the account after repeated failed logins but doesn't confirm the relationship to Change Tracker's default IP-blocking behavior. Please confirm:

    • UPDATE (clarify whether lockout replaces IP blocking or both can trigger independently)
    • KEEP (accept current neutral phrasing as-is)
  2. http-500-19-x-frame-options-duplicate-entry.md
    — The Cause doesn't explain why the upgrade produces a duplicate X-Frame-Options entry instead of replacing it, and no current X-Frame-Options value is available to include in the Resolution. Please confirm:

    • UPDATE (add the mechanism and the actual current value)
    • KEEP (accept current version if unconfirmed)
  3. mongodb-connection-timeout-socketexception-10060.md
    — The Cause explanation (connection pool exhaustion) reflects standard MongoDB .NET driver behavior but should be verified against Change Tracker's actual implementation. Please confirm:

    • UPDATE (adjust the mechanism if it doesn't match actual behavior)
    • KEEP (accept current version)
  4. turn-off-bulk-email-notifications.md
    — Two open items:
    (1) Config: Confirm the current file and key name for disabling bulk email notifications (localhost.json/enableBulkNotifications unverified against 8.2).
    (2) Content: What determines when changes are grouped into one bulk email (time window, report run, device, etc.), why a customer would want this off, and whether disabling it meaningfully increases email volume? Please confirm:

    • UPDATE (add the confirmed config file/key, plus the batching mechanism and rationale, to the article)
    • KEEP (accept as-is if unconfirmed)

Closes #1269

hilram7 added 2 commits July 24, 2026 17:20
…lete

Migrates 5 KB articles from the staging repo for Denis Goskolli's SME
review, with content depth work already applied via kb-writer. Two
Batch 4b candidates (File Content Max, File Hash Max for Extension)
are held pending clarification on the current agent config file
format, and are not included here.

Vale/Dale/Derek lint pass (kb-pr-open) not yet run — picking back up
in a later session.
…b articles

Applies the kb-pr-open Vale/Dale/Derek findings: bolds Command Prompt
where opened, fixes passive voice and positional references, corrects
a code-fence language mismatch, and reorders the bulk-email Overview
to lead with the goal sentence. Standardizes all SME Review Needed
inline flags to a consistent bracketed format. Converts the MongoDB
timeout article's backup instruction to an IMPORTANT callout rather
than its own step.
@hilram7
hilram7 requested a review from a team as a code owner July 27, 2026 18:37
@hilram7 hilram7 self-assigned this Jul 27, 2026
@hilram7 hilram7 assigned dgoskolli and unassigned hilram7 Jul 27, 2026
@hilram7 hilram7 changed the title Add Change Tracker KB batch 4 Add Change Tracker KB batch 4b Jul 27, 2026
Adjusted paths/key names to match current version of Change Tracker
Added the key found in the standard Change Tracker installation. Unsure what causes the duplicate key issue described in this article

@dgoskolli dgoskolli 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.

Review completed and articles have been updated with the correct details/comments

… review fixes for batch 4b

Turns SME (Denis Goskolli) review comments into actual article content
where his feedback was left as a comment but never committed: confirms
Account Lockout overrides the now-unused IP-blocking behavior in
stop-blocking-ip-address.md, and clears resolved SME placeholders in
mongodb-connection-timeout-socketexception-10060.md and
turn-off-bulk-email-notifications.md (plus best-judgment content for the
still-open batching-rationale question). Fixes a broken numbered list in
http-500-19-x-frame-options-duplicate-entry.md caused by an unindented
code block, and adds a best-judgment Cause explanation where the SME was
unsure of the root cause. Renames two article titles from generic
"Rolling-Log Fix:" to the established "<Component> Log Fix:" sibling
convention. Applies remaining Dale (passive voice, wordiness, misplaced
modifiers) and Derek (title format, product-name consistency, formatting)
fixes across all five changed KB articles.
@hilram7
hilram7 merged commit a662e24 into dev Aug 1, 2026
7 checks passed
@hilram7
hilram7 deleted the kb/changetracker-batch-4b branch August 1, 2026 03:44
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.

KB review: Add Change Tracker KB batch 4 (PR #1268)

2 participants