Skip to content

[WebGPU plugin EP] Update release and packaging-related docs#29059

Open
edgchen1 wants to merge 3 commits into
mainfrom
edgchen1/update_webgpu_plugin_ep_readmes
Open

[WebGPU plugin EP] Update release and packaging-related docs#29059
edgchen1 wants to merge 3 commits into
mainfrom
edgchen1/update_webgpu_plugin_ep_readmes

Conversation

@edgchen1

Copy link
Copy Markdown
Contributor

Description

WebGPU plugin EP doc updates:

  • document release process in more detail
  • fix some accuracy/clarity issues in other packaging-related docs and comments

Motivation and Context

Improve docs.

edgchen1 and others added 2 commits June 15, 2026 12:32
Fix the top-level README's outdated 'How it fits together' bullets (no ORT-Nightly publication happens; outputs are pipeline artifacts), and clarify that publishing to public feeds is handled by separate release pipelines.

Expand the bundled wheel and nupkg READMEs with Installation, Supported Platforms (incl. Windows DXC bundling and Linux Vulkan loader notes), and Troubleshooting sections that quote the actual version-mismatch error string from the plugin EP loader.

Align developer-facing READMEs (csharp/, python/): consistent pipeline-link style; cross-build constraint moved next to build instructions; CI Pipeline section dropped from csharp/README.md to match python/README.md; pack_nuget.py --artifacts-dir flow documented.

Also fix stale comment in plugin-webgpu-nuget-packaging-stage.yml (stage no longer runs a test) and align the RC versioning TODO in plugin-webgpu-packaging-stage.yml with the semver-dotted convention used in RELEASE.md.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Restructure the 'Release workflow' section into three clearly numbered phases (Prepare release branch / Build and validate packages / Release) with real Markdown numbered lists for the sub-steps, and add 'Step 1/2/3' prefixes to the H3 headings so cross-references are unambiguous.

Reorder Step 2 so fix integration happens before the packaging pipeline run, avoiding a redundant initial run on a patch branch that has only been version-bumped.

Emphasize the nuget.org publish-by-accident risk on the test-publishing step with a bold caution callout, add a worked example for the next-dev-version bump, and tighten back-references in Step 3.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
guschmue
guschmue previously approved these changes Jun 16, 2026
Align the Python and C# package READMEs around a user-focused structure and wording: matching top-level descriptions, consistent Linux Vulkan-loader prerequisite/troubleshooting guidance, and aligned troubleshooting remediation style.

Simplify Supported Platforms to platform/RID support lists (remove native binary filename implementation details, including DXC DLL mentions) to reduce maintenance drift and keep the docs focused on end-user decisions.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
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.

2 participants