Skip to content

Clarify docs folder guidance in AGENTS.md#21772

Merged
etraut-openai merged 1 commit into
mainfrom
etraut/docs-folder-guidance
May 8, 2026
Merged

Clarify docs folder guidance in AGENTS.md#21772
etraut-openai merged 1 commit into
mainfrom
etraut/docs-folder-guidance

Conversation

@etraut-openai
Copy link
Copy Markdown
Collaborator

@etraut-openai etraut-openai commented May 8, 2026

Summary

Codex keeps trying to add documentation to the docs/ directory. With the exception of app server API documentation, the docs for Codex should not live in this repo. We don't want the local docs/ folder to become a stale shadow of the official docs.

This PR updates AGENTS.md to make that boundary explicit and scopes the existing API documentation guidance to app-server docs/examples. It also removes the extra docs/config.md sections that were recently added.

@etraut-openai etraut-openai marked this pull request as ready for review May 8, 2026 16:37
@etraut-openai etraut-openai changed the title [codex] Clarify docs folder guidance Clarify docs folder guidance May 8, 2026
@etraut-openai etraut-openai changed the title Clarify docs folder guidance Clarify docs folder guidance in AGENTS.md May 8, 2026
@etraut-openai etraut-openai merged commit 0a0d09a into main May 8, 2026
37 of 38 checks passed
@etraut-openai etraut-openai deleted the etraut/docs-folder-guidance branch May 8, 2026 17:12
@github-actions github-actions Bot locked and limited conversation to collaborators May 8, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

2 participants