Skip to content

docs(test): redefine unit-vs-e2e policy for a6 #20

@guoqqqi

Description

@guoqqqi

Refs #19

Goal

Update repository guidance so the new testing rules are explicit and reviewable:

  • no new mocked APISIX Admin API command tests
  • command behavior coverage must go through real APISIX E2E
  • unit tests are reserved for pure logic and self-contained helpers
  • Ginkgo/Gomega is the target framework for E2E going forward

Scope

  • rewrite docs/testing-strategy.md
  • update AGENTS.md and any contributor guidance that still recommends httpmock for command-layer tests
  • document the allowed unit-test boundary and the disallowed mocked-command-test pattern
  • document migration policy for existing tests: phased removal, not one-shot deletion

Acceptance Criteria

  • repository docs no longer instruct authors to add mocked Admin API tests for pkg/cmd/**
  • docs clearly separate unit and e2e responsibilities
  • docs mention Ginkgo/Gomega as the standard E2E direction
  • reviewers can point to a single source of truth for future test PRs

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions