Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
70 changes: 70 additions & 0 deletions .github/ISSUE_TEMPLATE/bug_report.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,70 @@
name: Bug report
description: Report a reproducible problem
title: "[Bug]: "
labels:
- bug
body:
- type: markdown
attributes:
value: |
Thanks for reporting a bug. Please include enough detail to reproduce it.
- type: textarea
id: summary
attributes:
label: Summary
description: What is wrong?
placeholder: Clear and short description of the bug.
validations:
required: true
- type: textarea
id: reproduce
attributes:
label: Steps to reproduce
description: Share exact commands, config, and steps.
placeholder: |
1. Run `composer ic:tests`
2. ...
3. Observe ...
validations:
required: true
- type: textarea
id: expected
attributes:
label: Expected behavior
placeholder: What did you expect to happen?
validations:
required: true
- type: textarea
id: actual
attributes:
label: Actual behavior
placeholder: What happened instead? Include full error output if possible.
validations:
required: true
- type: input
id: php_version
attributes:
label: PHP version
placeholder: "e.g. 8.3.8"
validations:
required: true
- type: input
id: composer_version
attributes:
label: Composer version
placeholder: "e.g. 2.9.2"
validations:
required: true
- type: textarea
id: environment
attributes:
label: Environment details
description: OS, CI provider, shell, and anything else relevant.
placeholder: Ubuntu 24.04, GitHub Actions, bash...
validations:
required: true
- type: textarea
id: additional
attributes:
label: Additional context
description: Links, screenshots, logs, or related issues.
48 changes: 48 additions & 0 deletions .github/ISSUE_TEMPLATE/ci_failure.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
name: CI failure
description: Report a reproducible CI or workflow failure
title: "[CI]: "
labels:
- ci
body:
- type: markdown
attributes:
value: |
Use this form when CI fails unexpectedly and can be reproduced.
- type: input
id: workflow
attributes:
label: Workflow/job name
placeholder: security-standards / phpforge
validations:
required: true
- type: input
id: run_url
attributes:
label: Failing run URL
placeholder: https://github.com/OWNER/REPOSITORY/actions/runs/...
validations:
required: true
- type: textarea
id: command
attributes:
label: Failing command
description: Exact command or step that failed.
placeholder: composer ic:ci
validations:
required: true
- type: textarea
id: logs
attributes:
label: Error output
description: Paste the relevant error section.
render: shell
validations:
required: true
- type: textarea
id: local_check
attributes:
label: Local reproduction
description: Can you reproduce locally? If yes, include steps.
placeholder: Yes/No + details
validations:
required: true
1 change: 1 addition & 0 deletions .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
blank_issues_enabled: false
34 changes: 34 additions & 0 deletions .github/ISSUE_TEMPLATE/docs_improvement.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
name: Docs improvement
description: Report missing, unclear, or incorrect documentation
title: "[Docs]: "
labels:
- documentation
body:
- type: textarea
id: location
attributes:
label: Documentation location
description: File path or URL.
placeholder: README.md section "Quick Start"
validations:
required: true
- type: textarea
id: issue
attributes:
label: What is unclear or incorrect?
placeholder: This section says...
validations:
required: true
- type: textarea
id: suggestion
attributes:
label: Suggested improvement
description: Propose revised wording, structure, or examples.
placeholder: It would be clearer if...
validations:
required: true
- type: textarea
id: additional
attributes:
label: Additional context
description: Related links, screenshots, or prior discussions.
44 changes: 44 additions & 0 deletions .github/ISSUE_TEMPLATE/feature_request.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
name: Feature request
description: Suggest an improvement or new capability
title: "[Feature]: "
labels:
- enhancement
body:
- type: markdown
attributes:
value: |
Thanks for the idea. Please describe the use case first, then the proposed solution.
- type: textarea
id: problem
attributes:
label: Problem or use case
description: What limitation are you hitting?
placeholder: I need to...
validations:
required: true
- type: textarea
id: proposal
attributes:
label: Proposed solution
description: What should happen?
placeholder: Add a command/config/workflow option that...
validations:
required: true
- type: textarea
id: alternatives
attributes:
label: Alternatives considered
description: Any workaround or alternative approach you evaluated.
- type: textarea
id: impact
attributes:
label: Expected impact
description: Who benefits and what changes for users/CI?
placeholder: This would improve...
validations:
required: true
- type: textarea
id: additional
attributes:
label: Additional context
description: Related issues, links, examples, or prior art.
40 changes: 40 additions & 0 deletions .github/ISSUE_TEMPLATE/question.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
name: Question
description: Ask a usage or integration question
title: "[Question]: "
labels:
- question
body:
- type: markdown
attributes:
value: |
Use this form for usage questions. For confirmed defects, use the bug report form.
- type: textarea
id: context
attributes:
label: What are you trying to do?
description: Describe your goal and expected outcome.
placeholder: I want to...
validations:
required: true
- type: textarea
id: attempted
attributes:
label: What have you tried?
description: Include commands, config snippets, or links you already checked.
placeholder: I tried...
validations:
required: true
- type: textarea
id: output
attributes:
label: Current output or behavior
description: Include relevant command output, logs, or errors.
render: shell
- type: textarea
id: environment
attributes:
label: Environment details
description: PHP version, Composer version, OS, CI provider (if relevant).
placeholder: PHP 8.3, Composer 2.9, Ubuntu 24.04...
validations:
required: true
51 changes: 51 additions & 0 deletions .github/ISSUE_TEMPLATE/regression_report.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
name: Regression report
description: Report behavior that previously worked but now fails
title: "[Regression]: "
labels:
- regression
- bug
body:
- type: textarea
id: summary
attributes:
label: Regression summary
placeholder: This worked before, but now...
validations:
required: true
- type: input
id: last_known_good
attributes:
label: Last known working version/commit
placeholder: v1.2.3 or abc1234
validations:
required: true
- type: input
id: first_bad
attributes:
label: First broken version/commit
placeholder: v1.2.4 or def5678
- type: textarea
id: reproduce
attributes:
label: Steps to reproduce
placeholder: |
1. ...
2. ...
3. ...
validations:
required: true
- type: textarea
id: expected_actual
attributes:
label: Expected vs actual behavior
placeholder: Expected ..., but got ...
validations:
required: true
- type: textarea
id: environment
attributes:
label: Environment details
description: PHP version, Composer version, OS, CI provider (if relevant).
placeholder: PHP 8.3, Composer 2.9, Ubuntu 24.04...
validations:
required: true
33 changes: 33 additions & 0 deletions .github/PULL_REQUEST_TEMPLATE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
## Summary

Describe what changed and why.

## Related Issues

Link issues with `Closes #...` or `Relates #...`.

## Type of Change

- [ ] Bug fix
- [ ] New feature
- [ ] Refactor
- [ ] Documentation update
- [ ] CI or tooling update
- [ ] Other (describe in summary)

## Validation

List the commands you ran and their result.

```bash
composer ic:tests
```

If full suite was not run, explain why and list focused checks.

## Checklist

- [ ] I followed `CONTRIBUTING.md`.
- [ ] I added or updated tests for behavior changes.
- [ ] I updated docs/config/examples when needed.
- [ ] I confirmed no security-sensitive data is exposed.
Loading