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
60 changes: 60 additions & 0 deletions .github/ISSUE_TEMPLATE/qa-feedback.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
name: QA Feedback (Docs Revamp)
description: Report a problem found during the May 14–20 docs revamp QA testing window
title: "[QA] "
labels:
- "qa/may-2026"
body:
- type: markdown
attributes:
value: |
Thanks for helping QA the docs revamp! One issue per problem, please — easier to track and close out.

- type: dropdown
id: tab
attributes:
label: Which tab?
description: The tab where you found the issue. This determines who triages it.
options:
- Learn
- EVM Developers
- Native SDKs
- Operators
- Reference
- Solutions
- Support
validations:
required: true

- type: input
id: page-url
attributes:
label: Page URL or path
description: The dev-branch URL or file path (e.g. `evm/quickstart/deploy-with-hardhat.mdx`)
placeholder: "evm/quickstart/deploy-with-hardhat.mdx"
validations:
required: true

- type: textarea
id: problem
attributes:
label: What's the problem?
description: Short description of what's wrong. Include expected vs actual behavior if relevant (e.g. for code samples that don't run).
placeholder: |
e.g. The `npm install` command on this page errors out with "package not found" because the package name was renamed.
validations:
required: true

- type: textarea
id: suggestion
attributes:
label: Suggested fix (optional)
description: If you know how to fix it, tell us. Otherwise leave blank.
validations:
required: false

- type: markdown
attributes:
value: |
---

**Reminder:** after submitting, add the `tab/<name>` label matching the tab you picked above (e.g. `tab/evm`). If you have permission to add a priority label (`P1`/`P2`/`P3`), do that too.
38 changes: 38 additions & 0 deletions revamp/setup-qa-labels.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
#!/bin/bash
# ============================================================================
# Hedera Docs QA Labels Setup
# ============================================================================
# Creates the minimal set of GitHub labels for the docs revamp QA campaign.
#
# Labels:
# - 7 tab labels (one per documentation tab) for routing to working-group pairs
# - 1 campaign label (qa/may-2026) to distinguish QA feedback from regular issues
#
# Priority labels (P1, P3) already exist in the repo and are reused as-is.
# Type labels (broken-link, outdated-code, etc.) intentionally omitted —
# the issue title and body convey this information without needing taxonomy.
#
# Usage:
# ./revamp/setup-qa-labels.sh
#
# Requires: gh CLI authenticated against the hedera-docs repo
# Safe to re-run: --force updates existing labels rather than erroring
# ============================================================================

set -e

echo "Creating tab labels..."
gh label create "tab/learn" --color "0E8A16" --description "Issue in the Learn tab" --force
gh label create "tab/evm" --color "1D76DB" --description "Issue in the EVM Developers tab" --force
gh label create "tab/native" --color "5319E7" --description "Issue in the Native SDKs tab" --force
gh label create "tab/operators" --color "B60205" --description "Issue in the Operators tab" --force
gh label create "tab/reference" --color "FBCA04" --description "Issue in the Reference tab" --force
gh label create "tab/solutions" --color "D93F0B" --description "Issue in the Solutions tab" --force
gh label create "tab/support" --color "5DADE2" --description "Issue in the Support tab" --force

echo "Creating QA campaign label..."
gh label create "qa/may-2026" --color "0E8A16" --description "Filed during May 15–20 QA testing window" --force

echo ""
echo "Done. 8 labels created/updated."
echo "Testers should apply: 1 tab label + qa/may-2026 (+ optional priority)."
Loading