Skip to content

[agent docs]add reporting guide - #14531

Merged
yiyixuxu merged 3 commits into
mainfrom
reporting-guide
Aug 27, 2026
Merged

[agent docs]add reporting guide#14531
yiyixuxu merged 3 commits into
mainfrom
reporting-guide

Conversation

@yiyixuxu

Copy link
Copy Markdown
Collaborator

No description provided.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@yiyixuxu
yiyixuxu requested a review from stevhliu August 19, 2026 01:05
@github-actions github-actions Bot added the size/M PR with diff < 200 LOC label Aug 19, 2026
@yiyixuxu
yiyixuxu requested a review from sayakpaul August 19, 2026 01:05

@sayakpaul sayakpaul left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Super nice!

Comment thread .ai/reporting.md Outdated
Comment thread .ai/reporting.md Outdated

A reproduction is **what you were doing when it broke, with everything unnecessary removed** — start from the real failing situation and delete, don't build a clean synthetic case from scratch. The test: can someone paste it into a terminal and see the same failure, without first accepting your theory of the cause? A script that demonstrates your theory is not a reproduction — it can pass while the real bug is still there.

- Keep the real model, settings, and dtype. A repro that downloads weights and takes two minutes is worth more than a fast synthetic one.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

But we should also ask it to strive to be minimal even in that regard. For example, just using the bare minimum dependencies, and no externalities at all (like invoking diffusers from a servlet for example). Thoughts?

@stevhliu stevhliu left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks!

Comment thread .ai/reporting.md Outdated
Comment thread .ai/reporting.md Outdated
Comment thread .ai/reporting.md Outdated
Comment thread .ai/reporting.md Outdated
Comment thread .ai/reporting.md Outdated
Comment thread .ai/reporting.md Outdated
Comment thread .ai/reporting.md Outdated
yiyixuxu and others added 2 commits August 26, 2026 16:52
Co-authored-by: Steven Liu <59462357+stevhliu@users.noreply.github.com>
Move the reporting guide to .ai/references/ (the guides were restructured on main) and link it from the
reference-guides list; link the bug-report template by URL so the guide stays valid once installed.
@yiyixuxu
yiyixuxu merged commit 8125893 into main Aug 27, 2026
5 checks passed
@yiyixuxu
yiyixuxu deleted the reporting-guide branch August 27, 2026 03:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/M PR with diff < 200 LOC

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants