Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[guidelines] side-quest-21-01-sub-agent-syntax.md: checklist checkbox count exceeds 10-item limit

Open Beginner friendly
  • Is something wrong?
#4,409 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
62/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
markdown
Domain
documentation

Research direction

Start with the three "Quick check" lists in workshop/side-quest-21-01-sub-agent-syntax.md at lines 69-71, 92-94 and 106-107, and read the "Checkpoint checklist size limit" rule in .github/workflows/guidelines.md. Convert those lists to plain bullets as the issue recommends, leaving the five Checkpoint-section items as checkboxes. Done when the page has 10 or fewer task-list checkboxes and the Checkpoint progress bar still works.

Written by the indexing model from the issue text.

Description

documentation guidelines

File reviewed

workshop/side-quest-21-01-sub-agent-syntax.md

Violations

Checkpoint checklist size limit

Offending text:

The page contains 13 total checkboxes across all checklists combined:

  • "Quick check" list after "Fix the heading first" (3 items, lines 69-71)
  • "Quick check" list after "Keep only the sub-agent fields" (3 items, lines 92-94)
  • "Quick check" list after "Move the block to the bottom" (2 items, lines 106-107)
  • Final ## :white_check_mark: Checkpoint section (5 items, lines 156-160)

Suggested fix:
Per .github/workflows/guidelines.md ("Checkpoint checklist size limit"), a page must have a maximum of 10 checkboxes combined across all checklists. This page has 13. Either (a) convert the three in-exercise "Quick check" lists to plain prose/bullet confirmations instead of task-list checkboxes (since they are rendered as static indicators before the Checkpoint heading and arguably don't need to be interactive checkboxes), or (b) trim the final Checkpoint section and merge overlapping items (e.g., combine "I kept description" and "I kept or intentionally removed model" into one item) to bring the total to 10 or fewer. Recommend option (a): keep the 5 post-Checkpoint-heading items as-is (they drive the progress bar) and rewrite the three pre-Checkpoint "Quick check" lists as plain non-checkbox bullet lists, since guideline text notes pre-Checkpoint checkboxes are "static, non-interactive indicators" anyway and don't need list-item checkbox syntax to serve that purpose.

Generated by 📋 Guidelines Enforcer · copilot · auto · 87.4 AIC · ⌖ 5.54 AIC · ⊞ 9.7K · ◷

  • expires on Oct 17, 2026, 4:03 AM UTC
Dominant language
JavaScript
Stars
53
Forks
35
Avg merge
13h 50m
Merged PRs (30d)
14

Getting set up

Open in Codespaces

Starts the project's dev container in your browser, under your own GitHub account.

  • No Dockerfile or Docker Compose file
  • No pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from githubnext/gh-aw-workshop

All issues in githubnext/gh-aw-workshop

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.