Skip to content

Migrate 4 Change Tracker KB articles#249

Open
hilram7 wants to merge 9 commits intodevfrom
kb-changetracker-migration
Open

Migrate 4 Change Tracker KB articles#249
hilram7 wants to merge 9 commits intodevfrom
kb-changetracker-migration

Conversation

@hilram7
Copy link
Copy Markdown
Collaborator

@hilram7 hilram7 commented Feb 19, 2026

Summary

Migrates 4 Change Tracker KB articles to the public repo, following KB Revision Master Plan v2.0.

New Category

  • configuration-and-setup/ - New category for configuration and maintenance articles (will accommodate many future KB articles)

Articles Added

1. Default Password Detection

Location: troubleshooting-and-errors/

  • Updated with legacy system notice for v8.0+
  • Clarifies that current versions autogenerate passwords

2. Redis Decoupling

Location: database-and-diagnostics/

  • Verified and ready for public
  • No changes needed from previous version

3. Network Ports Configuration

Location: configuration-and-setup/

  • Cleaned up and removed Log Tracker content (wrong product)
  • Restructured to How-To format per style guide
  • Updated navigation paths and metadata

4. Agent Updates from Console

Location: configuration-and-setup/

  • Comprehensive rewrite merging two duplicate articles
  • Added phased rollout strategy
  • Added testing checklist, rollback plan, and troubleshooting
  • Added version compatibility table with EOS notices
  • Added FAQ section

Files Changed

  • 4 new articles added
  • 1 new category folder created

Add 4 updated KB articles from private repo (docs-kb-staging):

New category:
- configuration-and-setup/ (for configuration and maintenance articles)

Articles added:
1. Default password detection (troubleshooting-and-errors)
   - Updated with legacy system notice for v8.0+
2. Redis decoupling (database-and-diagnostics)
   - Verified and ready for public
3. Network ports configuration (configuration-and-setup)
   - Cleaned up, removed Log Tracker content
   - Restructured to How-To format
4. Agent updates from console (configuration-and-setup)
   - Comprehensive rewrite with phased rollout strategy
   - Added troubleshooting, testing checklist, and FAQ

Part of KB Revision Master Plan v2.0
@hilram7 hilram7 marked this pull request as ready for review March 27, 2026 18:48
@hilram7 hilram7 requested a review from a team as a code owner March 27, 2026 18:48
@hilram7 hilram7 marked this pull request as draft March 27, 2026 20:56
…ferences

- Created centralized 0-images folder following KB structure pattern
- Added 6 images for default password detection article (warning indicators and script output examples)
- Updated all image paths to reference ./../0-images/ instead of local ./images/ paths
- Images now properly organized for public KB documentation
- Convert absolute docs.netwrix.com URLs to relative paths
- Fix versioned URL format (8.0 → 8_0) in internal links
- Remove broken Salesforce CDN image references
- Remove .html extensions from internal doc links
hilram7 added 2 commits March 31, 2026 13:44
- Removed related links to gen-7-agent-deployment-options from
  how-to-update-agents-from-the-change-tracker-console.md and
  how-to-determine-what-network-ports-need-to-be-open-for-change-tracker-or-log-trackerto-function.md
- Link will be restored when the article is revised and migrated
- Add Salesforce knowledge_article_id to front matter
- Fix NOTE capitalization to match KB style guide
- Restructure decouple-redis with Overview/Instructions headings
- Fix plain Note: to blockquote format in decouple-redis
- Simplify image paths in default-agent-password article
- Add text language specifier to bare code block in 403 article
hilram7 added 2 commits March 31, 2026 15:35
- Add at command requirement to Prerequisites section
- Add NOTE in Step 4 for Linux agents
- Add Red Hat at command article to Related Links
@hilram7
Copy link
Copy Markdown
Collaborator Author

hilram7 commented Mar 31, 2026

Additional Changes Since Initial PR

  • Link and image fixes:
    • converted absolute docs.netwrix.com URLs to relative paths
    • fixed versioned URL format (8.0 → 8_0)
    • removed broken Salesforce CDN image references
    • removed .html extensions from internal doc links
  • Removed unresolved references:
    • removed links to gen-7-agent-deployment-options
      • article pending migration
      • references will be restored in that article's PR
  • Style guide compliance:
    • fixed NOTE capitalization
    • added Salesforce knowledge_article_id to front matter for all articles
    • simplified image paths
    • added code block language specifiers
  • Redis article restructure:
    • renamed Scenario → Overview
    • added Instructions heading
    • adjusted subheading levels to match KB style guide
  • Linux agent prerequisite (agent updates article):
    • added at command requirement to Prerequisites
    • added inline NOTE in Step 4
    • added Red Hat reference to Related Links (based on SME feedback)

@hilram7 hilram7 marked this pull request as ready for review March 31, 2026 19:54
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.

1 participant