Merge branch 'development' into kk-nist-updates

Author: katarzyna-koltun-mx

.claude/skills/docs-polish/SKILL.md

@@ -20,7 +20,8 @@ Improve clarity and readability without changing meaning, structure, or paragrap
 * Simplify wordy or awkward phrasing
 * Improve word choice (more precise or accessible terms)
 * Change passive voice to active voice where appropriate
-* Remove bold and italics used for emphasis (reword or use alerts if needed)
+* Remove first-person plural (we, us, our, let's), except in release notes
+* Remove bold and italics used for emphasis (reword or use alert shortcodes if needed)
 * Apply Mendix style guide standards (overrides the Microsoft Writing Style Guide)
 * Apply Microsoft Writing Style Guide standards, unless they conflict with the Mendix style guide standards
 

.claude/skills/docs-proofread/SKILL.md

@@ -22,6 +22,7 @@ Do NOT:
 * Change passive voice to active voice
 * Simplify complex sentences
 * Reorganize content
+* Remove Markdown comments
 
 Priority order for determining scope:
 1. If the user has selected text in a file (check for `ide_selection` tags), only proofread the selected text in that file. Don't proofread the entire document.

.github/copilot-instructions.md

@@ -57,7 +57,7 @@ Search the tree to understand where your topic belongs before creating a new fil
 
 * **Guiding manual** – Microsoft Writing Style Guide (https://learn.microsoft.com/style-guide/). Apply grammar, inclusive language, terminology, and formatting rules from that document.
 * **Tone** – Clear, concise, active voice; use imperative mood for procedures; second person (you/your) when addressing readers. Keep a conversational, straightforward tone. Present tense. Use American English and write for a global audience. Prefer short, everyday words; avoid or explain jargon. Keep it simple—short sentences and fragments are easier to scan and read, and prune excess words. Avoid marketing language.
-* **Terminology** – Capitalize product names (Mendix, Studio Pro, Developer Portal); use “microflow”, “nanoflow”, etc. consistently. Never use e.g. or i.e.
+* **Terminology** – Capitalize product names (Mendix Portal, Studio Pro, Team Server); use “microflow”, “nanoflow”, etc. consistently. Never use e.g. or i.e.
 * **Text formatting** – Reserve bold for UI labels, button names, menu items, or other interface text, or for introductions in list items. Don't use italics except to refer to titles and sections. Use wording or alert shortcodes for emphasis; don't use text formatting for emphasis. Use code font only to wrap literal code, filenames, paths, or command-line input. Use `<kbd>` for keyboard shortcuts.
 * **Headings** – H1 is generated from the front‑matter title. Subsequent headings increment by one level at a time. Don't use bold or italics as a replacement for headings. Use title case. Never start headings with numbers.
 * **Lists and tables** – Bullet lists use asterisks; ordered lists use numbers followed by a period. If there are more than three data points per item, use a table instead. Use the same syntax and structure for all list items in a given list. Use complete sentences to introduce lists and tables, not partial sentences completed with the list items. 

.github/workflows/auto-assign-pr.yml

@@ -12,13 +12,27 @@ jobs:
 
     steps:
       - name: Assign PR to creator if on Technical Writers team
-        uses: actions/github-script@v7
+        uses: actions/github-script@v9
         with:
           script: |
             const creator = context.payload.pull_request.user.login;
             const prNumber = context.payload.pull_request.number;
             const assignees = context.payload.pull_request.assignees;
 
+            // Technical Writers team members
+            const techWriters = [
+              'ConnorLand',
+              'Karuna-Mendix',
+              'MariaShaposhnikova',
+              'MarkvanMents',
+              'NicoletaComan',
+              'OlufunkeMoronfolu',
+              'Yiyun333',
+              'dbreseman',
+              'katarzyna-koltun-mx',
+              'quinntracy'
+            ];
+
             console.log(`Processing PR #${prNumber} by ${creator}`);
             console.log(`Current assignees: ${assignees.length > 0 ? assignees.map(a => a.login).join(', ') : 'none'}`);
 
@@ -27,23 +41,15 @@ jobs:
               return;
             }
 
-            try {
-              console.log(`Checking if ${creator} is on technical-writers team...`);
-              await github.rest.teams.getMembershipForUserInOrg({
-                org: context.repo.owner,
-                team_slug: 'technical-writers',
-                username: creator
-              });
-
-              console.log(`${creator} is on technical-writers team, assigning PR...`);
+            if (techWriters.includes(creator)) {
+              console.log(`${creator} is on technical writers team, assigning PR...`);
               await github.rest.issues.addAssignees({
                 owner: context.repo.owner,
                 repo: context.repo.repo,
                 issue_number: prNumber,
                 assignees: [creator]
               });
               console.log(`Successfully assigned PR #${prNumber} to ${creator}`);
-            } catch (error) {
-              console.log(`${creator} is not on technical-writers team, skipping assignment`);
-              console.log(`Error details: ${error.message}`);
+            } else {
+              console.log(`${creator} is not on technical writers team, skipping assignment`);
             }

.github/workflows/branch-deletion-pr-creation.yml

@@ -19,7 +19,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
           token: ${{ secrets.GITHUB_TOKEN }}
@@ -115,7 +115,7 @@ jobs:
 
       - name: Create Deletion PR
         if: env.HAS_BRANCHES == 'true'
-        uses: peter-evans/create-pull-request@v6
+        uses: peter-evans/create-pull-request@v8
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           title: "[Auto] Branch Deletion Candidates - ${{ env.CURRENT_DATE }}"

.github/workflows/branch-deletion-pr-processing.yml

@@ -18,7 +18,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
           token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/check-claude-settings.yml

@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Check for Claude configuration changes
-        uses: actions/github-script@v7
+        uses: actions/github-script@v9
         with:
           script: |
             const comment = `⚠️ **Claude Configuration Warning**

.github/workflows/lint-action.yml

@@ -20,12 +20,12 @@ jobs:
     steps:
       # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
       - name: Checkout repo
-        uses: actions/checkout@v4
-      # Installs NodeJS v20 in runner environment (upgraded from v16 in Feb 2024)
+        uses: actions/checkout@v6
+      # Installs NodeJS v24 in runner environment (upgraded from v20 in Jun 2026)
       - name: Install NodeJS
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
-          node-version: '20'
+          node-version: '24'
       # Installs linting tool via npm
       # Look at using the related GitHub action here: https://github.com/DavidAnson/markdownlint-cli2-action
       - name: Install markdown linter
@@ -44,9 +44,9 @@ jobs:
           echo "VER<<EOF" >> $GITHUB_ENV
           echo "$VER" >> $GITHUB_ENV
           echo "EOF" >> $GITHUB_ENV
-      # Creates PR for linted content changes - needs version > 4 for NodeJS 20
+      # Creates PR for linted content changes - needs version > 6 for NodeJS 24
       - name: Create pull request
-        uses: peter-evans/create-pull-request@v6
+        uses: peter-evans/create-pull-request@v8
         with:
           commit-message: Run markdownlint-cli2 on docs to find (and correct) linting errors. 
           title: '[Auto] Lint docs'

.github/workflows/remunusedattachments.yml

@@ -20,15 +20,15 @@ jobs:
 
       # Checks out your repository under $GITHUB_WORKSPACE, so your job can access it
       - name: Checkout repo
-        uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
+        uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
         with:
           python-version: '3.10' 
       - run: python _scripts/removeUnusedAttachments.py
 
       # Creates pull request
       - name: Create Pull Request
-        uses: peter-evans/create-pull-request@v6
+        uses: peter-evans/create-pull-request@v8
         with:
           commit-message: Run removeUnusedAttachments.py on docs
           title: '[Auto] Remove unused attachments'

.github/workflows/vale.yml

@@ -0,0 +1,56 @@
+name: Vale Linting
+
+# Trigger on PRs that change Markdown files
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+    paths:
+      - 'content/en/docs/**/*.md'
+
+# Allow reading repo contents and posting PR comments
+# Note: Fork PRs from org members run automatically but get read-only tokens,
+# so reviewdog falls back to check annotations instead of review comments.
+# External contributors require workflow approval per repo settings.
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  vale:
+    # Only run on Mendix repo, not forks, and not on draft PRs
+    if: github.repository_owner == 'mendix' && github.event.pull_request.draft == false
+    runs-on: ubuntu-latest
+    env:
+      FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+    # Cancel old runs when new commits are pushed
+    concurrency:
+      group: ${{ github.workflow }}-${{ github.event.pull_request.number }}
+      cancel-in-progress: true
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v6
+        with:
+          sparse-checkout: |
+            .vale.ini
+            .vale
+            content/en/docs
+          sparse-checkout-cone-mode: false
+
+      - name: Get changed files
+        id: changed-files
+        run: |
+          FILES=$(gh pr view ${{ github.event.pull_request.number }} --json files --jq '.files[].path' | grep '^content/en/docs/.*\.md$' | paste -sd, -)
+          echo "files=$FILES" >> $GITHUB_OUTPUT
+        env:
+          GH_TOKEN: ${{ github.token }}
+
+      - name: Run Vale
+        if: steps.changed-files.outputs.files != ''
+        uses: vale-cli/vale-action@v2
+        with:
+          files: ${{ steps.changed-files.outputs.files }}
+          separator: ','
+          version: 3.14.2
+          fail_on_error: false
+          reporter: github-pr-review  # Uses filter_mode=added (default): only comment on modified lines
+          vale_flags: '--minAlertLevel=error'  # Only flag errors, not warnings or suggestions