Skip to content

Conversation

@etraut-openai
Copy link
Collaborator

This eliminates redundant user documentation and allows us to focus our documentation investments.

I left tombstone files for most of the existing ".md" docs files to avoid broken links. These now contain brief links to the developers docs site.

This eliminates redundant user documentation and allows us to focus our documentation investments.

I left tombstone files for most of the existing ".md" docs files to avoid broken links. These now contain brief links to the developers docs site.
@etraut-openai etraut-openai marked this pull request as ready for review January 2, 2026 17:02
@etraut-openai
Copy link
Collaborator Author

@codex review

Copy link
Contributor

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

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.

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

@etraut-openai etraut-openai merged commit ab75338 into main Jan 2, 2026
26 checks passed
@etraut-openai etraut-openai deleted the etraut/docs_update branch January 2, 2026 20:01
@github-actions github-actions bot locked and limited conversation to collaborators Jan 2, 2026
@bolinfest
Copy link
Collaborator

I agree the duality was not a great situation, but this also means that:

  • Code changes and doc changes are no longer made atomically.
  • Perhaps more importantly, Codex itself will not update the docs as part of making a code change.
  • External contributors cannot help with docs, which is something they often do.

Maybe we should try to use https://github.com/google/copybara or something to sync docs from this repo to the docs repo used to publish the site?

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants