Skip to content

fix product accuracy findings across agent guides - #329

Merged
anipotts merged 4 commits into
mainfrom
codex/product-accuracy-corrections
Oct 17, 2026
Merged

anipotts merged 4 commits into
mainfrom
codex/product-accuracy-corrections

Conversation

@anipotts

@anipotts anipotts commented Oct 17, 2026 •

Copy link
Copy Markdown
Owner

The guides described removed Codex MCP commands as deprecated, shipped Claude Mods as a proposal, and several cloud/local workflows too broadly. This corrects those claims against current primary documentation and fixes the other recorded configuration, memory, hooks, scheduling, handoff, Cowork, MCP and sandbox findings. The existing section audit records a disposition for each factual cluster.

Grok's configuration chapter now says “settings and access.” Sidebar and picker labels use canonical chapter titles, so that correction reaches navigation. Product overview labels retain their existing wording, and the former Function Hooks fragment remains an alias.

Accepted text, hidden drafts, archive compatibility and historical version receipts are preserved. All 31 previously matching acceptance/preservation records remain exact. Source dates are scoped to inspected claims; they do not grant wording acceptance or certify installed account behavior. The README queues small wording batches next.

Validation:

  • Local source registry, Astro/content/link checks, generated routes, build, performance budgets, 14 editorial tests, 9 setup tests, Markdown and JSON/Python/shell checks passed.
  • Local browser/navigation/search checks and the 378-case accessibility sweep passed across 21 routes, nine widths and both themes. All 11 affected public routes were inspected in the normal development server with their corrected passages present and no mobile overflow. Final GitHub checks own exact-revision release evidence.
  • Extracted instructional fixtures reproduce the expected failures and corrected successes. The hook shell fixture covers success and exit-2 failure; live hook registration, account access, sandbox enforcement, scheduled execution and handoff remain outside these checks.
  • Independent read-only reviews found no blocking correctness issue. Both automated review findings on the earlier revision are addressed: canonical navigation labels and direct app-server wording.

All 11 GitHub checks passed on 2e77da65eaf659dc9c5dab0f24546b95d0ebf0a1. A previous site-job attempt encountered a transient GitHub 503 for an existing source-registry link; that URL subsequently returned HTTP 200. No check was weakened or excluded.

Merged as 6bc72115ee9a42389eac2fbfc13ac44e6f123126; its tree matches the checked revision. GitHub Pages deployment succeeded for that exact merge. Live HTTP checks on October 17 verified all 11 affected public pages, corrected Grok navigation labels and the retained Mods alias. Local main is clean and matches origin/main. Wording acceptance remains unchanged; small wording batches are next.

@anipotts
anipotts marked this pull request as ready for review October 17, 2026 22:27
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 17, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-17T22:44:48.789588Z 2e77da6 New commits
🔒 Security Review ✅ Completed 2026-10-17T22:28:47.113893Z cfa4082 Draft marked ready
ℹ️ About Codex in GitHub

Your team has set up Codex to 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@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: cfa4082964

ℹ️ About Codex in GitHub

Your team has set up Codex to 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 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@@ -1,11 +1,11 @@
---
title: settings and memory
title: settings and access

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Keep the Grok navigation label in sync

On /guides/grok/configuration/, ChapterMenu.astro:30 ignores this title for product guides and resolves navigation order 30 through handbookChapters, whose label remains settings and memory in src/site.ts:66. Changing only the canonical title therefore leaves both sidebar variants advertising the old memory topic while the page is titled “settings and access”; render the page title or add a Grok-specific navigation label.

AGENTS.md reference: AGENTS.md:L29-L29

Useful? React with 👍 / 👎.

Comment thread content/guides/codex/extensions.md Outdated
Comment on lines +135 to +136
their own supported operations; an app server method does not establish a
matching desktop tool. history tells you what has happened; status and new events help you keep up with what happens next.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge State the app-server distinction directly

The newly added sentence defines the distinction through what an app-server method does not establish, which is the negative-comparison construction prohibited in public copy. Keep the preceding positive statement that desktop task tools expose their own supported operations, or name the concrete mapping directly instead of defining it by absence.

AGENTS.md reference: AGENTS.md:L16-L16

Useful? React with 👍 / 👎.

@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: 2e77da65ea

ℹ️ About Codex in GitHub

Your team has set up Codex to 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 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +91 to +92
unattended runs retain the default sandbox. they gain no extra access;
organization policy also constrains approval behavior.

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 State the scheduled task approval policy

For scheduled tasks in workspaces that permit it, OpenAI documents that runs use approval_policy = "never"; only an admin requirement that disallows never makes them fall back to the selected permission mode. Saying merely that organization policy “constrains” approvals hides that these unattended runs normally execute without approval prompts, which matters especially when the default sandbox is full access. State that behavior explicitly alongside the sandbox boundary. OpenAI’s scheduled-task documentation describes both branches.

AGENTS.md reference: AGENTS.md:L60-L60

Useful? React with 👍 / 👎.

@anipotts
anipotts merged commit 6bc7211 into main Oct 17, 2026
11 checks passed
@anipotts
anipotts deleted the codex/product-accuracy-corrections branch October 17, 2026 22:46
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