Skip to content

docs: replace Shader Playground links - #8887

Open
KAVYANSH KUMAR (kavyansh18) wants to merge 1 commit into
microsoft:mainfrom
kavyansh18:docs/replace-shader-playground-links
Open

docs: replace Shader Playground links#8887
KAVYANSH KUMAR (kavyansh18) wants to merge 1 commit into
microsoft:mainfrom
kavyansh18:docs/replace-shader-playground-links

Conversation

@kavyansh18

Copy link
Copy Markdown

Description

The SPIR-V Cookbook documentation currently contains links to the
deprecated Shader Playground service, which are no longer available.

This change replaces those dead links with the corresponding
Compiler Explorer (Godbolt) links.

Changes

  • Updated the introductory text in docs/SPIRV-Cookbook.rst to
    reference Compiler Explorer instead of Tim Jones' Shader Playground.
  • Replaced all 22 dead Shader Playground URLs with their corresponding
    Compiler Explorer URLs.
  • Preserved all existing HLSL examples and documentation structure.
  • No changes were made to the shader logic, including existing
    [numthreads(...)] attributes.
  • The [numthreads] declarations remain unchanged in the examples,
    ensuring that the documented compute shader thread-group configurations
    are preserved exactly as before.

Validation

  • Verified that all 22 Shader Playground URLs were replaced.
  • Verified that no shader-playground references remain in
    SPIRV-Cookbook.rst.
  • Verified that all 22 replacement Compiler Explorer links are present
    and reachable.
  • Successfully parsed the reStructuredText documentation with docutils.
  • Ran the repository's generic documentation linter successfully.
  • Verified that no HLSL code, [numthreads] attributes, or unrelated
    documentation were modified.

Related Issue

Fixes #8885

Copilot AI balanced review requested due to automatic review settings September 5, 2026 18:31
@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
There may be pipelines that require an authorized user to comment /azp run to run.

@kavyansh18

Copy link
Copy Markdown
Author

@microsoft-github-policy-service agree

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

The documentation-only updates were validated, with no unresolved issues.

Pull request overview

Replaces deprecated Shader Playground links in the SPIR-V Cookbook with Compiler Explorer sessions.

Changes:

  • Updates introductory guidance to reference Compiler Explorer.
  • Replaces all 22 obsolete URLs while preserving existing shader examples.
File summaries
File Description
docs/SPIRV-Cookbook.rst Updates the service reference and interactive example links.
Review details
  • Files reviewed: 1/1 changed files
  • Comments generated: 0
  • Review effort level: Balanced

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@V-FEXrt

Copy link
Copy Markdown
Collaborator

/azp run

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 1 pipeline(s).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: New

Development

Successfully merging this pull request may close these issues.

[Docs] Dead links to sunset ShaderPlayground webpage in docs/SPIRV-Cookbook.rst

3 participants