Skip to content

[Doc] Fix compound types doc#767

Open
hughperkins wants to merge 3 commits into
mainfrom
hp/fix-compound-types-doc
Open

[Doc] Fix compound types doc#767
hughperkins wants to merge 3 commits into
mainfrom
hp/fix-compound-types-doc

Conversation

@hughperkins

Copy link
Copy Markdown
Collaborator

Issue: #

Brief Summary

copilot:summary

Walkthrough

copilot:walkthrough

@hughperkins

Copy link
Copy Markdown
Collaborator Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6f59cabc11

ℹ️ 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".


- **`@qd.data_oriented` containers** must be passed via `qd.Template` (or be the `self` of a `@qd.kernel` method on a `@qd.data_oriented` class). Using a typed-dataclass annotation on the outermost arg errors.
| Kernel parameter compound type | Annotation |
| `@dataclasses.dataclass` | `MyDataclass` (dataclass type) |

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Restore the table separator row

The new table goes directly from the header to the first data row, so Markdown/MyST will not recognize it as a table; readers will see the raw pipe-delimited text instead of the intended annotation matrix. Please add a delimiter row such as |---|---| before this row.

Useful? React with 👍 / 👎.

@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown

Comment on lines +307 to +309
| Kernel parameter compound type | Annotation |
| `@dataclasses.dataclass` | `MyDataclass` (dataclass type) |
| `@qd.data_oriented` | `qd.Template` |

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

The markdown table is missing the required separator row between the header and data rows. Without the separator row (e.g., |---|---|), the table will not render correctly.

The table should be:

| Kernel parameter compound type | Annotation |
|---|---|
| `@dataclasses.dataclass`       | `MyDataclass` (dataclass type) |
| `@qd.data_oriented`            | `qd.Template` |
Suggested change
| Kernel parameter compound type | Annotation |
| `@dataclasses.dataclass` | `MyDataclass` (dataclass type) |
| `@qd.data_oriented` | `qd.Template` |
| Kernel parameter compound type | Annotation |
|--------------------------------|------------------------------|
| `@dataclasses.dataclass` | `MyDataclass` (dataclass type) |
| `@qd.data_oriented` | `qd.Template` |

Spotted by Graphite

Fix in Graphite


Is this helpful? React 👍 or 👎 to let us know.

@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown

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.

1 participant