Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

site: generate a changelog page and the README "Recent" block from docs/review-ledger.md

オープン
#91 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
52/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
活発
技術スタック
javascript

調査の方向性

Read build.mjs, sync-counts.mjs, site/lib/markdown.mjs, and lib.test.mjs to understand the existing site build, rendering, and README update patterns. Then inspect docs/review-ledger.md, README.md, and ROADMAP.md to trace the source format and completion criteria. Done means /changelog/ is generated and linked, the README Recent block comes from the ledger, parser coverage is added, and the roadmap item is marked Done.

索引モデルが issue の本文から書いたものです。

説明

documentation enhancement priority: medium

Why it matters
docs/review-ledger.md is a 1,300-line, well-structured record of every sweep, but it is invisible from the site and the README. The README's "Recent:" blockquote restates three of its entries by hand and will drift. A changelog page gives returning visitors a reason to come back, shows contributors what a good sweep looks like, and is already under "Planned" in ROADMAP.md.

Evidence

  • ROADMAP.md, Planned: "A changelog page generated from docs/review-ledger.md".
  • README.md ~lines 50-53, the hand-maintained "Recent:" block.
  • The ledger uses a strict shape (## YYYY-MM-DD (title) then bullets), so it parses with site/lib/markdown.mjs.

Suggested approach

  1. In build.mjs, split the ledger on ## date headings, render the newest N sections with the existing renderer, write dist/changelog/index.html with the shared page shell, and add it to the sitemap, footer and llms.txt.
  2. Have sync-counts.mjs (or a sibling step) rewrite the README "Recent:" block from the three newest ledger headings, the same way it rewrites counts, so it cannot drift.
  3. Optionally emit changelog.xml as a second Atom feed.

Done when
/changelog/ is live and linked, the README block is generated, lib.test.mjs covers the ledger parser, and the ROADMAP item moves to Done.

主要言語
JavaScript
スター
58
フォーク
15
平均マージ
16時間 53分
マージ済み PR(30日)
14

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

TMHSDigital/Free-Game-Dev-Assets のほかの issue

TMHSDigital/Free-Game-Dev-Assets の issue をすべて見る

似ている issue

JavaScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。