Skip to content

chore(tooling): add test-docstring guidance to the write-test skill - #3328

Merged
marioevz merged 1 commit into
ethereum:forks/amsterdamfrom
spencer-tb:chore/write-test-docstring-guidance
Aug 6, 2026
Merged

chore(tooling): add test-docstring guidance to the write-test skill#3328
marioevz merged 1 commit into
ethereum:forks/amsterdamfrom
spencer-tb:chore/write-test-docstring-guidance

Conversation

@spencer-tb

Copy link
Copy Markdown
Contributor

Description

Adds a "Test Docstrings" section to the write-test skill: keep test docstrings to a short summary of the rule under test, don't narrate what the code already expresses (parametrized cases, gas decompositions, case-by-case outcomes), prefer inline comments for anything the code can't show, and never hardcode numeric gas values.

Follows the review feedback on #3318.

Related Issues or PRs

N/A.

Checklist

  • Ran fast static checks to avoid CI fails, see Code Standards & Verifying Changes: just static
  • PR title has the form <type>(<area>): <title>, where <type> and <area> come from an appropriate C-<type>, respectively A-<area>, label. The title should match the target squash commit message.

Cute Animal Picture

cat

@spencer-tb
spencer-tb marked this pull request as ready for review August 6, 2026 12:56
@spencer-tb

Copy link
Copy Markdown
Contributor Author

PR created by yours truly, fable 5 :)

@marioevz marioevz 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!

@marioevz
marioevz merged commit f6cf6a9 into ethereum:forks/amsterdam Aug 6, 2026
1 check passed
CPerezz added a commit that referenced this pull request Aug 7, 2026
…3332)

* feat(tests): add eth_getTransactionReceipt batching (#3298)

* feat(tests): add EIP-2780 coverage gap tests (#3318)

* feat(test-tests): add engine payload attribute and genesis parity tests (#3309)

* fix(test-execute): register per-test hive test cases with the shared client (#3317)

* fix(tests): accept gas allowance error at EIP-7778 admission gate (#3330)

* chore(tooling): add test-docstring guidance to the write-test skill (#3328)

---------

Co-authored-by: Jochem Brouwer <jochembrouwer96@gmail.com>
Co-authored-by: spencer <spencer.taylor-brown@ethereum.org>
Co-authored-by: danceratopz <danceratopz@gmail.com>
Co-authored-by: milen <94537774+taratorio@users.noreply.github.com>
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