Fix DevTool documentation: screenshots, version, navigation, wording, and plugin ID links (After Lint Error Fix) by kasivn · Pull Request #511 · AdobeDocs/uxp-photoshop

kasivn · 2026-07-08T11:44:49Z

Description

Updates the DevTool documentation: replaces the outdated "all apps" UDT screenshot with a current one, corrects the version reference in the installation guide, fixes the UDT walkthrough navigation and wording along with its accompanying images, and updates outdated plugin ID documentation links.

Changes:

Replaced ccd-allapps-udt.png with ccd-apps-udt.png to reflect the current UI
Updated installation.md
Updated UDT walkthrough images (udt-gear-icon.png, udt-start.png)
Fixed navigation/content in the UDT walkthrough index.md, including clearer wording for the empty plugins pane and correcting the gear-icon action to open the "preferences sheet" to match the actual UDT UI label
Updated Developer Distribution plugin ID links from the outdated plugin_id path to the canonical plugin-id path across the DevTool and related guides (plugin-management.md, udt-walkthrough/index.md, packaging-your-plugin/index.md, manifest-v4/index.md)

Motivation and Context

The DevTool docs contained an outdated screenshot, an incorrect version reference, a navigation issue in the UDT walkthrough, unclear wording, and several plugin ID links pointing to an old URL path that now only resolves via redirect. These caused confusion for users following the guide. This change brings the screenshots and content in line with the current product UI, corrects the navigation and copy, and points the plugin ID links at their canonical destination so they remain valid as the site migration proceeds.

How Has This Been Tested?

Verified locally by running the docs site (npm run dev) and confirming the updated pages render correctly:

New screenshots display properly and match the current UI
The corrected version reference appears as expected on the installation page
Updated plugin ID links resolve directly to the canonical Developer Distribution page
Wording changes read correctly in context

Types of changes

Bug fix (non-breaking change which fixes an issue)
New feature (non-breaking change which adds functionality)
Breaking change (fix or feature that would cause existing functionality to change)

Checklist:

I have signed the Adobe Open Source CLA.
My code follows the code style of this project.
My change requires a change to the documentation.
I have updated the documentation accordingly.
I have read the CONTRIBUTING document.
I have added tests to cover my changes.
All new and existing tests passed.

github-actions · 2026-07-08T11:52:59Z

🔍 Linter Report

Click to expand full report

═══════════════════════════════════════════════════════════════
                     LINTER REPORT
═══════════════════════════════════════════════════════════════

Generated: 2026-07-08T11:46:49.419Z
Mode: Full Linting (all rules + dead links check)
Target Directory: /home/runner/work/uxp-photoshop/uxp-photoshop

───────────────────────────────────────────────────────────────

Files to process: 498

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/community/index.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 27:20
    Message: Unexpected dead URL `https://www.adobe.com/subscription/ccdevnewsletter.html`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/guides/code-samples/index.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 175:1
    Message: Unexpected dead URL `https://github.com/AdobeDocs/uxp-photoshop-plugin-samples/tree/main/io-websocket-sample`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/guides/devtool/installation.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 21:53
    Message: Unexpected dead URL `https://creativecloud.adobe.com/apps/download/uxp-developer-tools`, expected live URL
    Rule: no-dead-urls

  ⚠️  WARNING
    Location: Line 23:62
    Message: Unexpected dead URL `https://creativecloud.adobe.com/apps/download/creative-cloud`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/guides/devtool/plugin-management.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 27:214
    Message: Unexpected dead URL `https://developer.adobe.com/developer-distribution/creative-cloud/docs/guides/plugin-id/`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/guides/devtool/udt-walkthrough/index.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 47:77
    Message: Unexpected dead URL `https://developer.adobe.com/developer-distribution/creative-cloud/docs/guides/plugin-id/`, expected live URL
    Rule: no-dead-urls

  ⚠️  WARNING
    Location: Line 105:252
    Message: Unexpected dead URL `https://developer.adobe.com/developer-distribution/creative-cloud/docs/guides/plugin-id/`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/guides/distribution/packaging-your-plugin/index.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 25:122
    Message: Unexpected dead URL `https://developer.adobe.com/developer-distribution/creative-cloud/docs/guides/plugin-id/`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/guides/hybrid-plugins/distribute/index.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 13:79
    Message: Unexpected dead URL `https://developer.adobe.com/developer-distribution/creative-cloud/docs/guides/getting_started/`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/guides/hybrid-plugins/getting-started/index.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 17:138
    Message: Unexpected dead URL `https://developer.adobe.com/developer-distribution/creative-cloud/docs/guides/faq/#what-do-i-do-when-i-get-access-denied-upon-login`, expected live URL
    Rule: no-dead-urls

  ⚠️  WARNING
    Location: Line 37:73
    Message: Unexpected dead URL `https://helpx.adobe.com/ca/photoshop/kb/debug-plugins-in-photoshop-bigsur.html`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/guides/index.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 20:100
    Message: Unexpected dead URL `https://www.adobe.com/creativecloud/desktop-app.html`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/guides/legacy-extensibility/index.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 38:1
    Message: Unexpected dead URL `https://www.adobe.com/devnet/photoshop/sdk.html`, expected live URL
    Rule: no-dead-urls

  ⚠️  WARNING
    Location: Line 22:90
    Message: Unexpected dead URL `https://www.adobe.com/devnet/photoshop/scripting.html`, expected live URL
    Rule: no-dead-urls

  ⚠️  WARNING
    Location: Line 31:5
    Message: Unexpected dead URL `https://www.adobe.io/apis/creativecloud/cep.html`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/guides/uxp-guide/uxp-misc/manifest-v4/index.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 81:92
    Message: Unexpected dead URL `https://developer.adobe.com/developer-distribution/creative-cloud/docs/guides/plugin-id/`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/guides/uxp-guide/uxp-misc/uxp-toolchain/index.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 39:3
    Message: Unexpected dead URL `https://www.npmjs.com/`, expected live URL
    Rule: no-dead-urls

  ⚠️  WARNING
    Location: Line 59:109
    Message: Unexpected dead URL `https://www.npmjs.com/`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/ps-reference/changelog/index.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 761:23
    Message: Unexpected dead URL `https://adobe.ly/psmodal`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/ps-reference/classes/document.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 92:63
    Message: Unexpected dead URL `https://helpx.adobe.com/photoshop/using/cloud-documents-faq.html`, expected live URL
    Rule: no-dead-urls

  ⚠️  WARNING
    Location: Line 48:1
    Message: Unexpected dead URL `https://www.adobe.com/go/ps-api-uxp-filesystemprovider`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/ps-reference/media/batchplay.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 196:33
    Message: Cannot find heading for `#hidelayerexample`
    Rule: missing-heading

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/ps-reference/media/imaging.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 69:3
    Message: Cannot find heading for `#getpixels`
    Rule: missing-heading

  ⚠️  WARNING
    Location: Line 70:3
    Message: Cannot find heading for `#getlayermask`
    Rule: missing-heading

  ⚠️  WARNING
    Location: Line 71:3
    Message: Cannot find heading for `#getselection`
    Rule: missing-heading

  ⚠️  WARNING
    Location: Line 72:3
    Message: Cannot find heading for `#createimagedatafrombuffer`
    Rule: missing-heading

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/ps-reference/media/uxpscripting.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 51:34
    Message: Unexpected dead URL `https://creativecloud.adobe.com/apps/download/uxp-developer-tools`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/scripting/getting-started/index.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 24:43
    Message: Unexpected dead URL `https://creativecloud.adobe.com/apps/download/uxp-developer-tools`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/uxp-api/changelog3-p.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 134:100
    Message: Unexpected dead URL `https://www.npmjs.com/search?q=swc-uxp-wrappers`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/uxp-api/reference-js/global-members/data-transfers/web-socket.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 122:54
    Message: Unexpected dead URL `https://developer.mozilla.org/en-US/docs/Web/API/WebSocket#close()`, expected live URL
    Rule: no-dead-urls

  ⚠️  WARNING
    Location: Line 122:191
    Message: Unexpected dead URL `https://developer.mozilla.org/en-US/docs/Web/API/WebSocket#close()`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/uxp-api/reference-js/global-members/html-dom/class-list.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 116:10
    Message: Unexpected dead URL `https://dom.spec.whatwg.org/#dom-domtokenlist-item`, expected live URL
    Rule: no-dead-urls

  ⚠️  WARNING
    Location: Line 146:10
    Message: Unexpected dead URL `https://dom.spec.whatwg.org/#dom-domtokenlist-supports`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/uxp-api/reference-js/global-members/html-dom/intersection-observer.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 48:10
    Message: Unexpected dead URL `https://developer.mozilla.org/en-US/docs/Web/API/IntersectionObserver/threshold`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/uxp-api/reference-js/global-members/html-dom/tree-walker.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 39:10
    Message: Unexpected dead URL `https://dom.spec.whatwg.org/#dom-treewalker-lastchild`, expected live URL
    Rule: no-dead-urls

  ⚠️  WARNING
    Location: Line 44:10
    Message: Unexpected dead URL `https://dom.spec.whatwg.org/#dom-node-previoussibling`, expected live URL
    Rule: no-dead-urls

  ⚠️  WARNING
    Location: Line 49:10
    Message: Unexpected dead URL `https://dom.spec.whatwg.org/#dom-treewalker-nextsibling`, expected live URL
    Rule: no-dead-urls

  ⚠️  WARNING
    Location: Line 54:10
    Message: Unexpected dead URL `https://dom.spec.whatwg.org/#dom-treewalker-previousnode`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/uxp-api/reference-js/global-members/html-elements/html-web-view-element.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 37:114
    Message: Unexpected dead URL `https://*.adobe.com/`, expected live URL
    Rule: no-dead-urls

  ⚠️  WARNING
    Location: Line 263:128
    Message: Unexpected dead URL `https://developer.apple.com/documentation/foundation/1448136-nserror_codes`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/uxp-api/reference-js/modules/uxp/entry-points/entry-points.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 29:901
    Message: Unexpected dead URL `https://developer.adobe.com/xd/uxp/develop/reference/ui/panels/update/`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/uxp-api/reference-js/modules/uxp/xmp/getting-started/xmp.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 13:50
    Message: Unexpected dead URL `https://www.adobe.com/devnet/xmp.html`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/uxp-api/reference-js/modules/uxp/xmp/xmp-classes/xmp-const.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 15:78
    Message: Unexpected dead URL `http://purl.org/dc/elements/1.1`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/uxp-api/reference-spectrum/spectrum-uxp-widgets/user-interface/sp-divider.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 16:3
    Message: Unexpected dead URL `https://opensource.adobe.com/spectrum-web-components/components/rule`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/uxp-api/reference-spectrum/spectrum-uxp-widgets/user-interface/sp-dropdown.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 16:3
    Message: Unexpected dead URL `https://opensource.adobe.com/spectrum-web-components/components/dropdown`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/uxp-api/reference-spectrum/spectrum-uxp-widgets/using-with-react.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 42:357
    Message: Unexpected dead URL `https://github.com/AdobeDocs/uxp-photoshop-plugin-samples/blob/main/ui-react-starter/src/components/ColorPicker.jsx#L40`, expected live URL
    Rule: no-dead-urls

───────────────────────────────────────────────────────────────
📄 FILE: src/pages/uxp-api/reference-spectrum/swc/index.md
───────────────────────────────────────────────────────────────
  ⚠️  WARNING
    Location: Line 66:3
    Message: Unexpected dead URL `https://www.npmjs.com/package/@swc-uxp-wrappers/create-swc-uxp-app`, expected live URL
    Rule: no-dead-urls

  ⚠️  WARNING
    Location: Line 67:3
    Message: Unexpected dead URL `https://www.npmjs.com/package/@swc-uxp-wrappers/create-swc-uxp-react-app`, expected live URL
    Rule: no-dead-urls


═══════════════════════════════════════════════════════════════
                        SUMMARY
═══════════════════════════════════════════════════════════════

  📁 Files processed:    498
  📄 Files with issues:  31
  ❌ Total errors:       0
  ⚠️  Total warnings:     48
  📋 Total issues:       48

Result: ⚠️  PASSED WITH WARNINGS - No fatal errors

═══════════════════════════════════════════════════════════════

This comment was automatically generated by the linter bot.

karan0207

Looks good, ready for merging.

kasivn added 5 commits June 23, 2026 17:33

Fix screenshots, version, and UDT navigation

79cb05f

Fix plugin ID doc links: plugin_id → plugin-id

dd0954c

clarify UDT center pane description and gear icon label

c9870a8

Update Connected Applications description in UDT walkthrough

9d1807f

Merge branch 'main' into kasi-fixes

96729ba

kasivn requested review from hollyschinsky and karan0207 July 8, 2026 11:44

karan0207 approved these changes Jul 8, 2026

View reviewed changes

karan0207 merged commit 1d3b3b2 into main Jul 8, 2026
2 checks passed

Navigation Menu

Fix DevTool documentation: screenshots, version, navigation, wording, and plugin ID links (After Lint Error Fix) - #511

Fix DevTool documentation: screenshots, version, navigation, wording, and plugin ID links (After Lint Error Fix)#511
karan0207 merged 5 commits into
mainfrom
kasi-fixes

kasivn commented Jul 8, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jul 8, 2026

Uh oh!

karan0207 left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

kasivn commented Jul 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Motivation and Context

How Has This Been Tested?

Types of changes

Checklist:

Uh oh!

github-actions Bot commented Jul 8, 2026

🔍 Linter Report

Uh oh!

karan0207 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

kasivn commented Jul 8, 2026 •

edited

Loading