akanealw
eec8c28fb3
Some checks failed
Go Benchmark / Performance Regression Check (push) Has been cancelled
Cerberus Integration / Cerberus Security Stack Integration (push) Has been cancelled
Upload Coverage to Codecov / Backend Codecov Upload (push) Has been cancelled
Upload Coverage to Codecov / Frontend Codecov Upload (push) Has been cancelled
CodeQL - Analyze / CodeQL analysis (go) (push) Has been cancelled
CodeQL - Analyze / CodeQL analysis (javascript-typescript) (push) Has been cancelled
CrowdSec Integration / CrowdSec Bouncer Integration (push) Has been cancelled
Docker Build, Publish & Test / build-and-push (push) Has been cancelled
Quality Checks / Auth Route Protection Contract (push) Has been cancelled
Quality Checks / Codecov Trigger/Comment Parity Guard (push) Has been cancelled
Quality Checks / Backend (Go) (push) Has been cancelled
Quality Checks / Frontend (React) (push) Has been cancelled
Rate Limit integration / Rate Limiting Integration (push) Has been cancelled
Security Scan (PR) / Trivy Binary Scan (push) Has been cancelled
Supply Chain Verification (PR) / Verify Supply Chain (push) Has been cancelled
WAF integration / Coraza WAF Integration (push) Has been cancelled
Docker Build, Publish & Test / Security Scan PR Image (push) Has been cancelled
Repo Health Check / Repo health (push) Has been cancelled
History Rewrite Dry-Run / Dry-run preview for history rewrite (push) Has been cancelled
Prune Renovate Branches / prune (push) Has been cancelled
Renovate / renovate (push) Has been cancelled
Nightly Build & Package / sync-development-to-nightly (push) Has been cancelled
Nightly Build & Package / Trigger Nightly Validation Workflows (push) Has been cancelled
Nightly Build & Package / build-and-push-nightly (push) Has been cancelled
Nightly Build & Package / test-nightly-image (push) Has been cancelled
Nightly Build & Package / verify-nightly-supply-chain (push) Has been cancelled
86 lines
2.1 KiB
Markdown
Executable File
86 lines
2.1 KiB
Markdown
Executable File
# docs/issues - Issue Specification Files
|
|
|
|
This directory contains markdown files that are automatically converted to GitHub Issues when merged to `main` or `development`.
|
|
|
|
## How It Works
|
|
|
|
1. **Create a markdown file** in this directory using the template format
|
|
2. **Add YAML frontmatter** with issue metadata (title, labels, priority, etc.)
|
|
3. **Merge to main/development** - the `docs-to-issues.yml` workflow runs
|
|
4. **GitHub Issue is created** with your specified metadata
|
|
5. **File is moved** to `docs/issues/created/` to prevent duplicates
|
|
|
|
## Quick Start
|
|
|
|
Copy `_TEMPLATE.md` and fill in your issue details:
|
|
|
|
```yaml
|
|
---
|
|
title: "My New Issue"
|
|
labels:
|
|
- feature
|
|
- backend
|
|
priority: medium
|
|
---
|
|
|
|
# My New Issue
|
|
|
|
Description of the issue...
|
|
```
|
|
|
|
## Frontmatter Fields
|
|
|
|
| Field | Required | Description |
|
|
|-------|----------|-------------|
|
|
| `title` | Yes* | Issue title (*or uses first H1 as fallback) |
|
|
| `labels` | No | Array of labels to apply |
|
|
| `priority` | No | `critical`, `high`, `medium`, `low` |
|
|
| `milestone` | No | Milestone name |
|
|
| `assignees` | No | Array of GitHub usernames |
|
|
| `parent_issue` | No | Parent issue number for linking |
|
|
| `create_sub_issues` | No | If `true`, each `## Section` becomes a sub-issue |
|
|
|
|
## Sub-Issues
|
|
|
|
To create multiple related issues from one file, set `create_sub_issues: true`:
|
|
|
|
```yaml
|
|
---
|
|
title: "Main Testing Issue"
|
|
labels: [testing]
|
|
create_sub_issues: true
|
|
---
|
|
|
|
# Main Testing Issue
|
|
|
|
Overview content for the parent issue.
|
|
|
|
## Unit Testing
|
|
|
|
This section becomes a separate issue.
|
|
|
|
## Integration Testing
|
|
|
|
This section becomes another separate issue.
|
|
```
|
|
|
|
## Manual Trigger
|
|
|
|
You can manually run the workflow with:
|
|
|
|
```bash
|
|
# Dry run (no issues created)
|
|
gh workflow run docs-to-issues.yml -f dry_run=true
|
|
|
|
# Process specific file
|
|
gh workflow run docs-to-issues.yml -f file_path=docs/issues/my-issue.md
|
|
```
|
|
|
|
## Labels
|
|
|
|
Labels are automatically created if they don't exist. Common labels:
|
|
|
|
- **Priority**: `critical`, `high`, `medium`, `low`
|
|
- **Type**: `feature`, `bug`, `enhancement`, `testing`, `documentation`
|
|
- **Component**: `backend`, `frontend`, `ui`, `security`, `caddy`, `database`
|