📖 [Docs]: Test instructions updated to document per-test-file repository model

[Marius Storhaug (MariusStorhaug)]

Test instructions now document the per-test-file repository model — each test file owns its own repository, handles idempotent setup, cleans stale resources, and tears down after itself. Contributors following the instructions will correctly scope their tests to avoid cross-file interference during parallel execution.

• Fixes Update tests.instructions.md to document per-test-file repository model #597

Changed: Repository naming and ownership model

The instructions previously described a shared Test-{OS}-{TokenType}-{RunID} repository used by all test files. Each test file now owns its own repository using the pattern {TestName}-{OS}-{TokenType}-{RunID}, preventing resource collisions when tests run in parallel across OS matrices.

Resource	Pattern	Example
Repo	{TestName}-{OS}-{TokenType}-{RunID}	Releases-Linux-USER_FG_PAT-1234
Extra repo	{TestName}-{OS}-{TokenType}-{RunID}-{N}	Secrets-Linux-ORG_FG_PAT-1234-2

New: Self-containment principle

Each test file is now documented as fully self-contained:

1. BeforeAll ensures the test repository exists (idempotent creation) and cleans stale resources from prior runs with the same GITHUB_RUN_ID
2. AfterAll tears down all test-specific resources
3. Tests must work independently across parallel OSes and sequential auth contexts

Technical Details

• File changed: .github/instructions/tests.instructions.md
• "Shared test repositories" section renamed to "Per-test-file repositories"
• Updated all code examples, the naming conventions table, and the key rules section
• Updated frontmatter description to reflect the new scope
• Related issues: Use per-test-file scoped repositories and self-contained idempotent test setup #595 (test isolation implementation), Fix Install-GitHubApp 404 in Organizations tests — missing enterprise_organization_installations permission #596 (Organizations 404 fix)
• Implementation plan progress: All tasks from the implementation plan in Update tests.instructions.md to document per-test-file repository model #597 are completed by this PR.

[github-actions]

No Significant Changes Detected

This PR does not contain changes to files that would trigger a new release:

Path	Description
src/**	Module source code
README.md	Documentation

Build, test, and publish stages will be skipped for this PR.

If you believe this is incorrect, please verify that your changes are in the correct locations.

[github-actions]

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter

[Copilot]

Pull request overview

This docs-only PR updates the integration test instructions to describe a per-test-file repository model and a self-contained test lifecycle for files under tests/. The goal is to guide contributors and automation toward better test isolation during parallel runs.

Changes:

• Updates the instruction frontmatter and setup/teardown guidance to describe per-test-file repository ownership.
• Rewrites the example test-file structure to show repo provisioning plus stale-resource cleanup/teardown responsibilities.
• Replaces the repository naming rules and key rules with {TestName}-{OS}-{TokenType}-{RunID}-based guidance.