Skip to content

[DOC] Split Data Q&A into DATA_QA.md, frame as inner/outer loop#96

Open
chloe-kwak wants to merge 1 commit into
aws-samples:mainfrom
chloe-kwak:docs/data-qa-split
Open

[DOC] Split Data Q&A into DATA_QA.md, frame as inner/outer loop#96
chloe-kwak wants to merge 1 commit into
aws-samples:mainfrom
chloe-kwak:docs/data-qa-split

Conversation

@chloe-kwak

Copy link
Copy Markdown
Contributor

Summary

Extracts the Data Q&A section from deep-insight-web/README.md into a dedicated DATA_QA.md, and frames it as the inner loop (fast, conversational Text2SQL exploration) that complements the analysis outer loop (long-form multi-agent report) — mirroring the inner/outer loop framing used in the blog.

The README had grown to where the Data Q&A section was ~27% of the file, mixing "what it is" with deep operational detail (caching measurements, env vars, local dev, troubleshooting). This separates the two concerns: the README stays focused on "what it is and how to deploy", while the inner-loop deep dive lives next to it as a sibling doc.

Changes

  • deep-insight-web/README.md — replaced the long Data Q&A section with a concise outer loop / inner loop comparison table + link; moved the two Data Q&A-specific troubleshooting items
    (AccessDeniedException, Korean font □□□) into DATA_QA.md, keeping shared infra troubleshooting
    (image arch, container startup, task cycling) in the README.
  • deep-insight-web/DATA_QA.md (new) — how it works, Text2SQL highlights, prompt caching measurements, env vars, local development, inner-loop troubleshooting, and the Deep Insight Chat demo video.
  • README.md — updated the 2026/06 Latest News link to DATA_QA.md, added a Data Q&A demo entry in the Demo section, and noted the two workflows under Web UI Deployment.

Notes

  • No code changes — documentation only.
  • The old #data-qa anchor link is replaced everywhere it was referenced; no broken links remain.

Extract the Data Q&A section from deep-insight-web/README.md into a
dedicated DATA_QA.md, framed as the "inner loop" (fast Text2SQL chat)
that complements the analysis "outer loop" (long-form multi-agent
report) — mirroring the inner/outer loop framing used in the blog.

- deep-insight-web/README.md: replace the long Data Q&A section with a
  short outer/inner loop comparison table + link; move the two Data
  Q&A-specific troubleshooting items (AccessDenied, Korean font □□□)
  into DATA_QA.md, keeping shared infra troubleshooting in the README
- deep-insight-web/DATA_QA.md (new): how it works, Text2SQL highlights,
  prompt caching measurements, env vars, local dev, inner-loop
  troubleshooting, and the Deep Insight Chat demo video
- README.md: update the 2026/06 Latest News link to DATA_QA.md, add a
  Data Q&A demo entry in the Demo section, and note the two workflows
  under Web UI Deployment
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.

2 participants