Skip to content

[Doc] Fix doc quality check flagged issues on atomics.md#792

Open
hughperkins wants to merge 4 commits into
mainfrom
hp/atomics-doc-quality
Open

[Doc] Fix doc quality check flagged issues on atomics.md#792
hughperkins wants to merge 4 commits into
mainfrom
hp/atomics-doc-quality

Conversation

@hughperkins

Copy link
Copy Markdown
Collaborator

Issue: #

Brief Summary

copilot:summary

Walkthrough

copilot:walkthrough

Address doc-quality review for atomics.md:
- confine IR memory-scope spellings and native-vs-CAS lowering detail to a new
  '## Under the hood (advanced)' section
- drop internal C++ source-file citations, compiler-pass names, and RHI error
  details from end-user prose; keep the user-facing behavior
- define bit-packed/quantized fields inline instead of 'quant snodes'
The per-backend volatile_load lowering table describes IR/codegen/backend
internals (PTX, SPIR-V MemoryAccess, SPIRV-Cross); relocate it under
'## Under the hood (advanced)' and leave a user-facing pointer in the
semantics section.
@hughperkins
hughperkins marked this pull request as ready for review July 20, 2026 13:23
@hughperkins

Copy link
Copy Markdown
Collaborator Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Bravo.

Reviewed commit: 7d6e429a1e

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

The edited table footnotes used the daggers † / ‡, which the check_non_ascii
CI flags on added lines. Convert the † / ‡ / § footnote scheme to ASCII
[1] / [2] / [3] (definitions and references) for the What's available table.
@github-actions

Copy link
Copy Markdown

@hughperkins hughperkins added the awaiting review pass New PR or review comments addressed label Jul 20, 2026
- atomic_min/max table: drop LLVM/GLSL IR internals (llvm.minnum/maxnum,
  atomicrmw fmin/fmax, GLSL FMin/FMax) and the native-vs-CAS mechanics column;
  keep the user-facing f16 support and NaN-result behavior
- atomic_exchange table cell: drop the 'via uint-bitcast' codegen mechanic
- CPU 'native' note: reword to describe user-visible behavior, not codegen
- un-wrap the advanced-section intro paragraph (.md prose must not be wrapped)
@github-actions

Copy link
Copy Markdown

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

Labels

awaiting review pass New PR or review comments addressed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant