Restassured Documentation Tests

Use when Codex needs to add human-readable documentation to Rest Assured automation code, including class purpose, role boundaries, shared specs, and scenario intent.

jovd83 fc40112 2 files · 997 B Updated

File contents

Document Automation Code

1. Document Only What Helps

  1. Add class-level comments when the test role is not obvious.
  2. Add short comments before complex setup or custom filters.
  3. Do not add comments that restate the code literally.

2. Explain Boundaries

  1. Explain shared specs, auth helpers, builders, and virtualization seams.
  2. Explain why a test is tagged as smoke, contract, or integration when not obvious.

3. Troubleshooting

  1. Problem: The code already reads clearly. Fix: Do not add noise comments.

jovd83/restassured-skill/tree/main/documentation/tests commit fc40112768

Frequently asked questions

npx skillmds@latest add jovd83/restassured-documentation-tests