Align root tooling and linting

.github/workflows/deploy-github-pages.yml

@@ -3,6 +3,9 @@ name: Deploy GitHub Pages preview
 on:
   workflow_dispatch:
 
+# Note: GitHub Pages must be enabled on the repository with "GitHub Actions" as the source
+# (Settings → Pages → Build and deployment → Source → GitHub Actions)
+# Fork contributors must enable this on their fork before running this workflow.
 permissions:
   contents: read
   pages: write

.gitignore

@@ -1,19 +1,15 @@
-
-# OS and IDE generated files #
-##############################
+# OS and IDE generated files
 .DS_Store
 .vscode
 .history
 .idea
 .editorconfig
 .cursor
+.claude/
 
-# npm yarn
+# npm
 node_modules
-package.lock
-yarn-error.log
-.pnp.*
-.yarn/*
+package-lock.json
 
 # gatsby files
 .env
@@ -27,14 +23,16 @@ cypress/screenshots
 # lerna
 lerna-debug.log
 
-# local actions
-.actrc
-.secrets
-local-test.yml
+# static
+_site
+
+# Super-linter outputs
+super-linter-output
+super-linter.log
 
-# yalc
-.yalc
-yalc.lock
+# GitHub Actions leftovers
+github_conf
 
-# local
+# local dev
 tmp
+linter-report.txt

.markdownlint-cli2.jsonc

@@ -0,0 +1,12 @@
+{
+    // Ignore files referenced by .gitignore (only valid at root)
+    "gitignore": true,
+
+    // Define glob expressions to ignore
+    "ignores": [
+        "node_modules/",
+        "coverage/",
+        ".github/",
+        "src/pages/config.md"
+        ]
+}

.markdownlint.yml

@@ -18,8 +18,7 @@ MD007: false
 MD013: false
 
 # MD024/no-duplicate-heading - Multiple headings with the same content
-MD024:
-  siblings_only: true
+MD024: false
 
 # MD025/single-title/single-h1 - Multiple top-level headings in the same document
 MD025:
@@ -37,19 +36,19 @@ MD033:
     - InlineAlert
     - Edition
     - SuperHero
+    - CodeBlock
+    - Fragment
+    - Cards
+    - HorizontalLine
 
 # MD034/no-bare-urls - Bare URL used
 MD034: false
 
-# MD035/hr-style - Horizontal rule style
-MD035:
-  style: "---"
-
 # MD041/first-line-heading/first-line-h1 - First line in file should be a top level heading
 MD041: false
 
 # MD045/no-alt-text - Images should have alternate text
-MD045: false
+MD045: true
 
 # MD046/code-block-style - Code block style
 MD046:
@@ -66,5 +65,17 @@ MD049: false
 MD050:
   style: asterisk
 
+# MD052/reference-links-images - Reference links and images should have a title attribute (disabled for flexibility)
+MD052: false
+
+# MD054/link-image-style - Link and image style (disabled for flexibility)
+MD054:
+  autolink: false
+  url_inline: false
+
+# MD055/table-pipe-style - Require leading and trailing pipes (matches AM023)
+MD055:
+  style: leading_and_trailing
+
 # MD060/table-column-style - Table column style (disabled for flexible formatting)
 MD060: false

package.json

@@ -6,18 +6,24 @@
     "type": "git",
     "url": "https://github.com/AdobeDocs/commerce-admin-developer"
   },
-  "config": {
-    "sitePath": "commerce/admin-developer"
-  },
   "scripts": {
-    "dev": "node ./dev.mjs",
+    "dev": "npx --yes github:AdobeDocs/adp-devsite-utils dev",
+    "buildNavigation": "npx --yes github:AdobeDocs/adp-devsite-utils buildNavigation -v",
+    "buildRedirections": "npx --yes github:AdobeDocs/adp-devsite-utils buildRedirections -v",
+    "renameFiles": "npx --yes github:AdobeDocs/adp-devsite-utils renameFiles -v",
+    "normalizeLinks": "npx --yes github:AdobeDocs/adp-devsite-utils normalizeLinks -v",
+    "buildSiteWideBanner": "npx --yes github:AdobeDocs/adp-devsite-utils buildSiteWideBanner -v",
+    "buildSiteMetadata": "npx --yes github:AdobeDocs/adp-devsite-utils buildSiteMetadata -v",
+    "buildContributors": "npx --yes github:AdobeDocs/adp-devsite-utils buildContributors -v",
     "lint": "npx --yes github:AdobeDocs/adp-devsite-utils runLint -v",
+    "lint:errorOnly": "npx --yes github:AdobeDocs/adp-devsite-utils runLint",
+    "link:externalLinkOnly": "npx --yes github:AdobeDocs/adp-devsite-utils runLint --external-links-only -v",
+    "link:checkAllLinks": "npx --yes github:AdobeDocs/adp-devsite-utils runLint --internal-links-only --external-links-only -v",
+    "redirectCheck:stage": "npx --yes github:AdobeDocs/adp-devsite-utils redirectChecker stage --verbose",
+    "redirectCheck:prod": "npx --yes github:AdobeDocs/adp-devsite-utils redirectChecker prod --verbose",
     "lint:md": "npx --yes markdownlint-cli2 'src/pages/**/*.md' '*.md'",
     "lint:md:fix": "npx --yes markdownlint-cli2 --fix 'src/pages/**/*.md' '*.md'",
     "test": "npx --yes jest",
     "test:config": "npx --yes jest tests/config.test.js"
-  },
-  "devDependencies": {
-    "express": "5.2.1"
   }
 }

src/pages/adp-site-metadata.json

@@ -0,0 +1 @@
+{"total":3,"offset":0,"limit":3,"data":[{"key":"contributors","value":"src/pages/contributors.json"},{"key":"get-credentials","value":null},{"key":"site-wide-banner","value":null}],":type":"sheet"}

src/pages/contributors.json

@@ -0,0 +1 @@
+{"total":53,"offset":0,"limit":53,"data":[{"page":"/","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/14320591?v=4","https://avatars.githubusercontent.com/u/13662379?v=4","https://avatars.githubusercontent.com/u/11652541?v=4","https://avatars.githubusercontent.com/u/57922?v=4"],"lastUpdated":"11/12/2025"},{"page":"/config","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/14320591?v=4"],"lastUpdated":"11/17/2025"},{"page":"/pattern-library/","avatars":["https://avatars.githubusercontent.com/u/13662379?v=4","https://avatars.githubusercontent.com/u/12731225?v=4"],"lastUpdated":"9/11/2023"},{"page":"/pattern-library/containers/","avatars":["https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"9/11/2023"},{"page":"/pattern-library/containers/slideouts-modals-overlays","avatars":["https://avatars.githubusercontent.com/u/38460853?v=4","https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4","https://avatars.githubusercontent.com/u/6391769?v=4"],"lastUpdated":"3/12/2026"},{"page":"/pattern-library/containers/static-content","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"10/28/2024"},{"page":"/pattern-library/containers/tabs","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"11/14/2025"},{"page":"/pattern-library/controls/","avatars":["https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"9/11/2023"},{"page":"/pattern-library/controls/button-bar","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"10/28/2024"},{"page":"/pattern-library/controls/buttons","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"11/14/2025"},{"page":"/pattern-library/controls/expand-collapse","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"10/28/2024"},{"page":"/pattern-library/controls/view-controller","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"11/14/2025"},{"page":"/pattern-library/displaying-data/","avatars":["https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"9/11/2023"},{"page":"/pattern-library/displaying-data/datatable","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/14320591?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"11/14/2025"},{"page":"/pattern-library/displaying-data/filters","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/14320591?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"11/12/2025"},{"page":"/pattern-library/displaying-data/tile","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"10/28/2024"},{"page":"/pattern-library/displaying-data/tree","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"10/28/2024"},{"page":"/pattern-library/feedback-to-user/","avatars":["https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"9/11/2023"},{"page":"/pattern-library/feedback-to-user/progress-indicator","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"11/13/2025"},{"page":"/pattern-library/general/","avatars":["https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"9/11/2023"},{"page":"/pattern-library/general/accessibility-guidelines","avatars":["https://avatars.githubusercontent.com/u/38460853?v=4","https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"3/12/2026"},{"page":"/pattern-library/getting-user-input/","avatars":["https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"9/11/2023"},{"page":"/pattern-library/getting-user-input/date-time-selector","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"11/14/2025"},{"page":"/pattern-library/getting-user-input/form-elements","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"11/14/2025"},{"page":"/pattern-library/getting-user-input/image-uploader","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"11/14/2025"},{"page":"/pattern-library/getting-user-input/row-pattern","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"11/14/2025"},{"page":"/pattern-library/getting-user-input/select-from-list","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"11/14/2025"},{"page":"/pattern-library/getting-user-input/use-default-config","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"11/14/2025"},{"page":"/pattern-library/graphics/","avatars":["https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"9/11/2023"},{"page":"/pattern-library/graphics/iconography","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/14320591?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"11/14/2025"},{"page":"/pattern-library/navigation/","avatars":["https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"9/11/2023"},{"page":"/pattern-library/navigation/links","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"11/14/2025"},{"page":"/pattern-library/navigation/wizard","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"10/28/2024"},{"page":"/pattern-library/staging-patterns/","avatars":["https://avatars.githubusercontent.com/u/14320591?v=4","https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"3/18/2026"},{"page":"/pattern-library/staging-patterns/module","avatars":["https://avatars.githubusercontent.com/u/14320591?v=4","https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"3/18/2026"},{"page":"/pattern-library/staging-patterns/timeline-dashboard","avatars":["https://avatars.githubusercontent.com/u/14320591?v=4","https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"3/18/2026"},{"page":"/pattern-library/templates/","avatars":["https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"9/11/2023"},{"page":"/pattern-library/templates/address-form","avatars":["https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"9/11/2023"},{"page":"/pattern-library/templates/sign-in-form","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"11/13/2025"},{"page":"/style-guide/","avatars":["https://avatars.githubusercontent.com/u/13662379?v=4","https://avatars.githubusercontent.com/u/12731225?v=4"],"lastUpdated":"9/11/2023"},{"page":"/style-guide/content/","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4"],"lastUpdated":"11/17/2025"},{"page":"/style-guide/content/buttons-and-links","avatars":["https://avatars.githubusercontent.com/u/38460853?v=4","https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/14320591?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"3/12/2026"},{"page":"/style-guide/content/capitalization","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/14320591?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"11/13/2025"},{"page":"/style-guide/content/content-formats","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/14320591?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"11/14/2025"},{"page":"/style-guide/content/errors-and-messages","avatars":["https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"9/11/2023"},{"page":"/style-guide/content/headings-and-organization","avatars":["https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"9/11/2023"},{"page":"/style-guide/content/number-formats","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/14320591?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"11/14/2025"},{"page":"/style-guide/content/voice-and-tone","avatars":["https://avatars.githubusercontent.com/u/38460853?v=4","https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"3/12/2026"},{"page":"/style-guide/design/","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4"],"lastUpdated":"11/17/2025"},{"page":"/style-guide/design/color","avatars":["https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"9/11/2023"},{"page":"/style-guide/design/iconography","avatars":["https://avatars.githubusercontent.com/u/12731225?v=4","https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"11/14/2025"},{"page":"/style-guide/design/page-grids","avatars":["https://avatars.githubusercontent.com/u/13662379?v=4","https://avatars.githubusercontent.com/u/12731225?v=4"],"lastUpdated":"9/11/2023"},{"page":"/style-guide/design/typography","avatars":["https://avatars.githubusercontent.com/u/13662379?v=4"],"lastUpdated":"9/11/2023"}],":type":"sheet"}