Skip to content

Suggest adding a practical RAG and LLM debugging reference under Resources #140

@onestardao

Description

@onestardao

Hi,

Thank you for maintaining this repository. I like the practical, top down approach here, especially because it is aimed at software engineers who want a clear path from theory into real world ML work.

I would like to suggest adding one practical reference under the Resources section for a problem many developers run into once they move from model learning into modern LLM applications:

RAG and LLM debugging.

The resource I would like to propose is:

WFGY RAG 16 Problem Map
https://github.com/onestardao/WFGY/blob/main/ProblemMap/README.md

It is a docs first troubleshooting map for RAG and agent pipelines, organized into 16 reproducible failure modes with concrete fix directions.

Why I think it may fit this repository:

  1. This repo already focuses on practical learning paths for engineers.
  2. Many readers eventually move from ML learning into LLM apps, retrieval systems, and agent workflows.
  3. A compact debugging reference can help bridge the gap between learning concepts and fixing real production failures.

For context, this is not an isolated personal resource. The same 16 problem map has already been integrated, cited, or adapted across multiple projects in the RAG and agent ecosystem, including:

  • RAGFlow
  • LlamaIndex
  • ToolUniverse from Harvard MIMS Lab
  • Rankify from University of Innsbruck
  • Multimodal RAG Survey from QCRI LLM Lab
  • curated lists such as Awesome LLM Apps

Because of that, I thought it may also be a useful optional reference here for readers who want something practical after the learning stage.

If you think this is a reasonable fit, I would be happy to open a very small docs only PR and place it wherever you think makes the most sense.

Thanks again.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions