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

METRICS.md's own badge says 61 explainers; its own Targets table says 56 two sections later

Closed Beginner friendly
#697 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
85/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
python
Domain
documentation

Research direction

The issue points to METRICS.md lines 9 and 107. First, verify the current explainer count by running ls explainers/*.md | wc -l. Then, update the 'Current' cell in the Targets table from 56 to 61. Also, consider updating the '60+' target. Finally, edit scripts/check_explainer_count.py to add the Targets table line to the CHECKS list to prevent future drift.

Written by the indexing model from the issue text.

Description

documentation good first issue

Where: METRICS.md line 9 (badge) vs. line 107 (Targets table).

The gap:

Line 9:   ![Explainers](https://img.shields.io/badge/Explainers-61-blueviolet?style=flat-square)
Line 107: | Explainers | 56 | 60+ | End of 2026 |

The badge and the Targets table's "Current" column are both meant to state today's live explainer count, and they disagree within the same file. The real count is 61:

$ ls explainers/*.md | wc -l
61

scripts/check_explainer_count.py (which CI runs) doesn't catch this - its CHECKS list only tracks 6 specific regexes (README's "Show all N explainers", "Explainers Published | N", "N short, plain-language write-ups"; CONTRIBUTORS.md's "the bulk of the N explainers"; METRICS.md's Explainers-N-blueviolet badge itself; and ROADMAP.md's "N explainers published") - the Targets table's own "Explainers" row isn't in that list, so it drifted silently. Also worth noting: the real count (61) already exceeds the Targets table's own "60+" target.

Repro:

$ python3 scripts/check_explainer_count.py
OK: all 6 explainer-count mentions match explainers/*.md (61 files).

Passes cleanly even though this 7th, untracked mention is stale.

Fix direction: Update the Targets table's Explainers "Current" cell from 56 to 61 (and reconsider the "60+" target, already exceeded), and add this line to check_explainer_count.py's CHECKS list so it can't drift silently again.

Dominant language
HTML
Stars
47
Forks
45
Avg merge
1h 56m
Merged PRs (30d)
97

Getting set up

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 yakew7/Fair-Code

All issues in yakew7/Fair-Code

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.