Skip to content

dev to main#766

Merged
jth-nw merged 28 commits intomainfrom
dev
Apr 15, 2026
Merged

dev to main#766
jth-nw merged 28 commits intomainfrom
dev

Conversation

@jth-nw
Copy link
Copy Markdown
Collaborator

@jth-nw jth-nw commented Apr 15, 2026

No description provided.

krzysztofstaszalek and others added 27 commits April 14, 2026 17:52
	modified:   docs/endpointprotector/admin/dc_module/globalrights.md
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* Fix dale linting violations across 24 articles

Resolves passive voice, wordiness, positional references, minimizing-difficulty,
undefined acronyms, and idiom violations flagged by the dale linter. Defines
product-specific acronyms (NPS, EPE, SAM, CEE, AMQP, FSAA, SPAA, SPAC, SPSEEK,
USN, RADIUS, CAP, NPR, DSM, SMB, CIFS, DoD, SVM, CORS, UNC) on first use across
KB and product docs.

* Move WinRM troubleshooting article from 1secure to privilegesecure

Article content is NPS-specific (Action Service, PSRemoting/WinRM) and was
incorrectly tagged with 'products: onesecure' during migration from Salesforce,
causing it to land in docs/kb/1secure/ instead of docs/kb/privilegesecure/.
Updates products frontmatter from onesecure to privilegesecure, moves file to
privilegesecure/troubleshooting-and-errors/, and removes orphaned duplicate
images from docs/kb/1secure/0-images/ (all 22 already present in
privilegesecure/0-images/).

* fix(kb): apply dale style fixes across multiple KB articles

- Write contractions out in full (do not, have not, are not)
- Convert headings to title case
- Rewrite passive voice constructions to active voice
- Fix truncated sidebar label in Privilege Secure AD FS article
- Fix bare URL and first-person language in permission scanning article
- Update support link in Privilege Secure byovconnectorconfig
Fix spelling of Netwrix 1Secure in documentation from 'Netwrix OneSecutre' to 'Netwrix 1Secure'
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…DE.md (#757)

* docs(kb): add folder organization guidance to KB CLAUDE.md

- covers placing new articles in product folders vs. category subfolders
- covers moving articles within the same product folder
- covers moving articles to a different product folder (images + frontmatter)
- covers creating new category folders with _category_.json
- notes to update incoming reference links when moving to avoid build errors

* docs(kb): add frontmatter rules and move guidance gaps to KB CLAUDE.md

- add Frontmatter section with all required fields inline; calls out
  mandatory kb tag explicitly so it's always in context
- add category tag update step to both move scenarios
- add note that only canonical docs/kb/ sources need link updates;
  versioned copies are regenerated by the build script
- add cross-product move step to review article body for old product
  name references
- add local testing note: kb:clean required after moves, not just restart
Replace 'objects' with 'components' for consistency with table updates
and add missing terminal period.

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
docs(platgovsalesforce): update permission set assignment requirements AB#426233
Create .vale/styles/NetwrixKB/ with eight rules scoped to KB articles,
and activate the style for docs/kb/**/*.md in .vale.ini.

Two rules are KB-specific:
- Contractions: flags contractions (don't, can't, it's, etc.) and prompts
  writing them out in full, the opposite of the existing Netwrix.Contractions rule
- HeadingCase: enforces Chicago-style title case for headings

Six rules are adapted from the Netwrix style: FirstPersonPlural, Please,
NoteThat, WeakLinkText, ImpersonalFiller, Utilize.

The docs/kb/**/*.md section previously had BasedOnStyles = (empty), which
disabled all Vale checking on KB files. KB files now receive NetwrixKB rules
only — the Netwrix style is intentionally excluded to avoid the contractions
conflict (Netwrix promotes contractions; KB requires writing them out in full).

TSEs can run 'vale <kb-file>' locally for KB-specific feedback.
* docs(derek): add design spec and implementation plan

* docs: add KB style guide as source of truth for derek linter

* fix(kb-style-guide): remove parentheses from RAG heading, label frontmatter example

* feat(derek): add skill scaffold and rule schema

* feat(derek): add SKILL.md

* feat(derek): add frontmatter validation rules

* feat(derek): add article structure rule

* feat(derek): add prose rules batch 1 (passive voice, please, minimizing difficulty, note-that, impersonal)

* feat(derek): add prose rules batch 2 (contractions, title case, jargon, links)

* fix(derek): tighten rule reasons to reduce false positives

* Rebuild derek as holistic KB writing quality reviewer

Replace the rule-engine linter (18 YAML rule files) with a single
SKILL.md that reads kb_style_guide.md directly and reviews 5 areas:
frontmatter validity, article type and structure, title format,
product name usage, and keyword/description quality.

Vale and Dale handle mechanical violations (contractions, heading
case, passive voice, etc.) — derek explicitly skips those and focuses
on what they cannot catch.
* docs: add PPE supportability statement as KB article

Adds a new KB article defining support levels for Password Policy Enforcer versions (Active, Limited, and Discontinued), covering bug fix policy, security patch eligibility, and upgrade guidance. Positioned first within the Knowledge Base section for all three supported versions (10.2, 11.0, 11.1).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* fix(kb): review and fix PPE supportability article

- Reclassify article as How-To (Instructions) with Overview/Instructions structure
- Fix frontmatter: add kb tag, fix product ID, expand keywords to 11 items
- Remove product name from title; change to gerund form
- Fix first body mention to use full product name
- Convert :::note and :::tip admonitions to KB-style blockquote callouts
- Rewrite passive voice constructions to active voice
- Fix idioms: "leave you without guidance", "take advantage of", "hit an issue"
- Remove wordiness: "as effectively as possible"
- Add end punctuation to full-sentence bullet items

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: Hil-Ram-NWX <212961752+hilram7@users.noreply.github.com>
- Flag Docusaurus admonition blocks (:::note, :::tip, :::warning,
  :::danger) in KB articles — writers should use blockquote callouts
  (> **NOTE:** / > **IMPORTANT:**) instead
- knowledge_article_id: only flag if the field is present but empty;
  absent field is acceptable for articles not migrated from Salesforce
EPP small Changes to be committed:
* Remove NPR client DLL name from PPE doc

* fix(vale): auto-fix substitutions and removals

* fix(vale): auto-fix rewrites (AI-assisted)

* fix(dale): auto-fix documentation issues (AI-assisted)

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Version switcher incorrectly affecting training pages
@jth-nw jth-nw requested review from a team as code owners April 15, 2026 14:31
@jth-nw jth-nw requested review from a team as code owners April 15, 2026 14:31
@jth-nw jth-nw merged commit e9065eb into main Apr 15, 2026
4 of 7 checks passed
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.

7 participants