Skip to content

Align root tooling and linting#176

Merged
dshevtsov merged 6 commits intoAdobeDocs:mainfrom
commerce-docs:ds_sync-root-configs
Mar 27, 2026
Merged

Align root tooling and linting#176
dshevtsov merged 6 commits intoAdobeDocs:mainfrom
commerce-docs:ds_sync-root-configs

Conversation

@dshevtsov
Copy link
Copy Markdown
Contributor

Purpose of this pull request

This pull request (PR) aligns the repository root tooling and linting with current Adobe Developer Platform (ADP) DevSite conventions, turns on alternate text for images in Markdown lint rules, and updates pattern library and style guide topics so figures use descriptive alt text. It also adds generated site metadata files used by the platform and tightens .gitignore and GitHub Pages workflow notes.

Summary

  • Tooling: Replaced the local Express-based dev.mjs dev server with adp-devsite-utils (dev, navigation/redirect/metadata/contributor helpers, expanded runLint and link-check scripts). Removed legacy package.json config.sitePath and the express dev dependency.
  • Lint: Added .markdownlint-cli2.jsonc (gitignore-aware ignores). Updated .markdownlint.yml—notably enabled MD045 (image alt text), adjusted duplicate-heading and MDX allowlists for components, and aligned table pipe rules with team defaults.
  • Content: Swapped bare ![](...) image syntax for ![...](...) with short descriptive alt text across affected pattern library and style guide design pages.
  • Site assets: Added src/pages/adp-site-metadata.json and src/pages/contributors.json for ADP site integration.
  • Repo hygiene: Refreshed .gitignore (e.g. package-lock.json, build/super-linter artifacts, .claude/) and documented GitHub Pages source requirements in the deploy workflow.

Affected pages

Site base: https://developer.adobe.com/commerce/admin-developer (from src/pages/config.md pathPrefix).

Because many topics were touched for image alt text, listing section hubs plus representative pages:

Pattern library topics with content updates (image accessibility):

Style guide — design:

Infrastructure-only (no direct reader-facing doc rewrites beyond the above): .github/workflows/deploy-github-pages.yml, package.json, .gitignore, .markdownlint.yml, .markdownlint-cli2.jsonc, src/pages/adp-site-metadata.json, src/pages/contributors.json, removed dev.mjs.

@dshevtsov dshevtsov requested a review from a team March 27, 2026 22:30
@dshevtsov dshevtsov self-assigned this Mar 27, 2026
@dshevtsov dshevtsov added maintenance Repository upkeep migration content-quality Language, formatting, SEO metadata, authoring standards compliance labels Mar 27, 2026
@github-project-automation github-project-automation bot moved this to 📋 Needs Review in Commerce - Pull Requests Mar 27, 2026
@dshevtsov dshevtsov enabled auto-merge March 27, 2026 22:41
@dshevtsov dshevtsov merged commit a8de7e8 into AdobeDocs:main Mar 27, 2026
7 checks passed
@github-project-automation github-project-automation bot moved this from 📋 Needs Review to 🏁 Done in Commerce - Pull Requests Mar 27, 2026
@dshevtsov dshevtsov deleted the ds_sync-root-configs branch March 27, 2026 23:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content-quality Language, formatting, SEO metadata, authoring standards compliance maintenance Repository upkeep migration

Projects

Status: 🏁 Done

Development

Successfully merging this pull request may close these issues.

2 participants