File: content/manuals/ai/sandboxes/integrations/chatgpt.md
Issue
The Prerequisites section lists a requirement that creates a circular dependency:
An existing sandbox created from the Codex template. The template includes
the codex command required by the app's remote server.
But then the very next section (Connect) shows how to create this sandbox:
$ sbx create --name demo codex .
This is confusing because:
- It's listed as a prerequisite, but the instructions immediately show how to create it
- The term "Codex template" is undefined - readers don't know what this means or how it differs from other sandbox types
- It creates a circular flow: "you need X to proceed" → "here's how to create X"
Why this matters
A reader following these instructions would be confused about whether they need to do something before starting, or whether the Connect section is the actual starting point. The prerequisite implies they should already have a Codex sandbox, but the Connect section treats it as the first step.
Suggested fix
Either:
Option 1: Remove this from Prerequisites since the Connect section shows how to create it:
## Prerequisites
- SSH access set up. See [Editor and app integrations](_index.md#enable-ssh-access).
- The ChatGPT desktop app installed.
Option 2: Reframe it as informational rather than a prerequisite:
## Prerequisites
- SSH access set up. See [Editor and app integrations](_index.md#enable-ssh-access).
- The ChatGPT desktop app installed.
> [!NOTE]
> ChatGPT requires a sandbox running the Codex agent, which includes the
> `codex` command needed by the app's remote server. The Connect section
> shows how to create one.
Found by nightly documentation quality scanner
File:
content/manuals/ai/sandboxes/integrations/chatgpt.mdIssue
The Prerequisites section lists a requirement that creates a circular dependency:
But then the very next section (Connect) shows how to create this sandbox:
$ sbx create --name demo codex .This is confusing because:
Why this matters
A reader following these instructions would be confused about whether they need to do something before starting, or whether the Connect section is the actual starting point. The prerequisite implies they should already have a Codex sandbox, but the Connect section treats it as the first step.
Suggested fix
Either:
Option 1: Remove this from Prerequisites since the Connect section shows how to create it:
Option 2: Reframe it as informational rather than a prerequisite:
Found by nightly documentation quality scanner