Skip to content

ci: add issue templates for website bugs, enhancements and good first issues - #679

Merged
rootsongjc merged 1 commit into
masterfrom
ci/issue-templates
Jul 31, 2026
Merged

ci: add issue templates for website bugs, enhancements and good first issues#679
rootsongjc merged 1 commit into
masterfrom
ci/issue-templates

Conversation

@mesutoezdil

@mesutoezdil mesutoezdil commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

Why

Two things were wrong with issue labeling here.

The existing automation never worked. Both current templates declare labels: kind/documentation, but that label did not exist in this repository. GitHub drops an unknown label silently, with no warning on the issue or in the template. Since blank_issues_enabled: false forces everyone through a template, every issue filed here should have arrived labeled, and none did. That is most of why 18 of 21 open issues had no label before the recent manual pass.

Three issue types had no template. The repository only offered "Documentation issue" and "Documentation improvement", both about docs content. Site bugs (#659 wrong dates, #664 broken code blocks), enhancements (#658 SEO, #662 image sizing, #666 i18n) and good first issues had nowhere to go.

What changed

Labels created first, matching HAMi's names, colors and descriptions:

Label Color
kind/documentation 0075ca
kind/bug d73a4a
kind/feature C5DEF5

Labels live in repository settings rather than in the tree, so they are not part of this diff.

Templates added:

Template Label applied
good-first.md good first issue
site-bug.md kind/bug
enhancement.md kind/feature

Every template in the directory now maps to a label that exists:

doc-improvement.md -> kind/documentation
doc-issue.md       -> kind/documentation
enhancement.md     -> kind/feature
good-first.md      -> good first issue
site-bug.md        -> kind/bug

good-first.md mirrors the one in HAMi, including the /assign instruction and the note that good first issues are reserved for first-time contributors.

Effect

New issues arrive labeled without anyone doing a manual pass. The good first issue filter, which is how newcomers find an entry point, fills itself as maintainers file tasks under that template.

npm run format:check passes.

Summary by CodeRabbit

  • Documentation
    • Added structured issue templates for enhancement requests, good first issues, and website bug reports.
    • Templates provide guided prompts and relevant metadata to improve the consistency and completeness of submitted issues.

… issues

The repository had two templates, both for documentation content, and
blank issues are disabled. Site bugs, enhancements and good first issues
had no template to file under, so they were filed as documentation
issues or arrived with no useful classification.

Both existing templates also declared `labels: kind/documentation`, a
label that did not exist in this repository. GitHub drops an unknown
label silently, so the only issue automation present had never actually
applied anything. The kind/* labels now exist, matching the names,
colors and descriptions used in the HAMi repository.

The new templates follow the same pattern already used in HAMi, where
each template carries the label its issue type should have.

Signed-off-by: mesutoezdil <mesudozdil@gmail.com>
@hami-robot
hami-robot Bot requested a review from archlitchi July 29, 2026 13:17
@netlify

netlify Bot commented Jul 29, 2026

Copy link
Copy Markdown

Deploy Preview for project-hami ready!

Name Link
🔨 Latest commit 34d086d
🔍 Latest deploy log https://app.netlify.com/projects/project-hami/deploys/6a69fd5f7683fc0008b92eea
😎 Deploy Preview https://deploy-preview-679--project-hami.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@hami-robot
hami-robot Bot requested a review from windsonsea July 29, 2026 13:17
@hami-robot hami-robot Bot added the size/M label Jul 29, 2026
@coderabbitai

coderabbitai Bot commented Jul 29, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 99d149af-7228-442f-8e5f-b459e9b05e50

📥 Commits

Reviewing files that changed from the base of the PR and between 65354a0 and 34d086d.

📒 Files selected for processing (3)
  • .github/ISSUE_TEMPLATE/enhancement.md
  • .github/ISSUE_TEMPLATE/good-first.md
  • .github/ISSUE_TEMPLATE/site-bug.md

📝 Walkthrough

Walkthrough

Three GitHub issue templates were added for enhancement requests, good-first issues, and website bug reports. Each template includes issue metadata and structured prompts tailored to its submission type.

Changes

Issue template additions

Layer / File(s) Summary
Structured issue intake templates
.github/ISSUE_TEMPLATE/*
Adds templates for enhancements, good-first issues, and website bugs with preset metadata and guided submission sections.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Suggested labels: enhancement

Poem

A bunny reviews each template with care,
“For bugs and ideas, clear prompts now share.
Good first tasks hop into view,
With helpful steps for contributors too—
Three tidy paths bloom everywhere!”

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly matches the main change: adding issue templates for bugs, enhancements, and good first issues.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch ci/issue-templates

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@rootsongjc

Copy link
Copy Markdown
Contributor

Let's align labels first though. The repo has overlapping schemes: your new kind/, plus area/ and priority/*, plus four issues still labeled flat enhancement (#658 #662 #666 #680).

Proposal: standardize on kind/* (type), area/* (scope), priority/* (urgency).
Migrate those four to kind/feature and delete the flat bug/enhancement/documentation.

@mesutoezdil

mesutoezdil commented Jul 30, 2026

Copy link
Copy Markdown
Contributor Author

agreed, done:

#658 #662 #666 #680 now have kind/feature
and
flat bug, enhancement, documentation deleted

#680 already had kind/documentation, so it carries two kind/* labels now. which one do you want to keep?

@mesutoezdil

Copy link
Copy Markdown
Contributor Author

config is ready in #687, .coderabbit.yaml with labeling instructions limited to kind/bug, kind/feature, kind/documentation, plus a mutually exclusive group so a pr cannot get two type labels.

kept it a separate pr since it changes bot behaviour for every contributor, and left #680 alone until you say which kind/* should stay.

@rootsongjc rootsongjc left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/lgtm

@hami-robot

hami-robot Bot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: mesutoezdil, rootsongjc
Once this PR has been reviewed and has the lgtm label, please assign wawa0210 for approval. For more information see the Kubernetes Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@rootsongjc
rootsongjc merged commit 3e9663d into master Jul 31, 2026
12 of 13 checks passed
@rootsongjc
rootsongjc deleted the ci/issue-templates branch July 31, 2026 10:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants