docs: add practical RAG troubleshooting checklist#2487
docs: add practical RAG troubleshooting checklist#2487monkeyjack123 wants to merge 1 commit intoopenai:mainfrom
Conversation
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: cf276bc062
ℹ️ 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".
| @@ -0,0 +1,34 @@ | |||
| # RAG Troubleshooting Checklist | |||
There was a problem hiding this comment.
This commit adds articles/rag_troubleshooting_checklist.md but does not add a matching registry.yaml record, and this repo’s publication workflow requires new content to be registered for static-site inclusion; without that entry, the checklist will be present in the repo but omitted from cookbook.openai.com. Please add a registry item for this path (including its metadata) in the same change.
Useful? React with 👍 / 👎.
1 participant
Closes #2483\n\nAdds a compact, implementation-focused checklist for diagnosing RAG failures in production and links to relevant Cookbook examples.\n\n### What this PR includes\n- New article: articles/rag_troubleshooting_checklist.md\n- README pointer under a new RAG troubleshooting section\n\n### Why\nIssue #2483 asks for practical troubleshooting guidance for real-world RAG workflows. This PR provides a neutral, framework-agnostic checklist without external dependencies.