template-issues

Base template for all XeplosionGames repositories.

This repo contains the standard issue templates and PR template that are used consistently across the entire org. Every new XeplosionGames repo — regardless of stack, purpose, or whether it has CI/CD — is created from this template.

---

Using this template

If your repo needs CI/CD, deployments, or stack-specific tooling, do not use this template directly. Use the appropriate stack template instead — each one is already built on top of this repo:

Stack	Template repo
Infrastructure / config / scripts	template-script
.NET / C#	template-dotnet
Node / web frontend	template-node
Python	template-python
PHP	template-php

Use template-issues directly only for repos that are purely documentation, discussion, or organizational — such as org or .profile.

---

New repo setup

After creating a repo from any template, seed the standard project board by running create-project.sh from the XeplosionGames/.forgejo repo:

./scripts/create-project.sh XeplosionGames/your-repo-name <token>

This creates the following columns:

Triage → Backlog → To Do → In Progress → In Review → Done

---

Commit convention

All commits use Conventional Commits format with a trailing period:

<type>: <description>.

Type	Use for
feat:	New functionality
fix:	Bug fixes
chore:	Dependencies, tooling, refactors
docs:	Documentation only
ci:	CI/CD workflow changes
perf:	Performance improvements
test:	Adding or updating tests
style:	Formatting only, no logic change

Breaking changes: use feat!: or fix!:, or include BREAKING CHANGE: in the commit body.

---

Files

File	Purpose
ISSUE_TEMPLATE/bug_report.yml	Bug report form
ISSUE_TEMPLATE/feature_request.yml	Feature request form
ISSUE_TEMPLATE/question.yml	Question / discussion form
ISSUE_TEMPLATE/docs_update.yml	Docs update form
ISSUE_TEMPLATE/chore.yml	Chore / maintenance form
ISSUE_TEMPLATE/investigation.yml	Investigation / spike form
ISSUE_TEMPLATE/vulnerability.yml	Security vulnerability form
pull_request_template.md	PR description template

---

Keeping templates up to date

Issue templates are maintained in XeplosionGames/.forgejo. When they are updated, copy the relevant files into this repo. Existing repos must be updated manually or via the sync workflow once available.