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

ci: docs routing skips the BReg facility OpenAPI source

オープン 初心者向け
#2,162 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

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

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

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
90/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
javascript, openapi, python

調査の方向性

まず .github/scripts/ci_changes.py と、現在検出されていないパス products/breg/generated/facility/generated/openapi.json から始めます。ドキュメントのソースパターンを更新し、カバレッジテストを、*.openapi.json だけで絞り込むのではなく、SPEC_SOURCES のすべてのエントリを列挙するように修正します。BReg 施設ドキュメントの変更によって、ドキュメントのジョブと renderer/Redocly のチェックが実行されることを確認します。

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

説明

Found in review of #2132.

docs/site/scripts/fetch-openapi.mjs renders products/breg/generated/facility/generated/openapi.json as the BReg API reference example. The docs routing in .github/scripts/ci_changes.py does not list that path. A change that only regenerates the facility document therefore skips the docs job, including the renderer and Redocly checks.

The coverage test misses it too: its source extraction accepts only filenames ending in .openapi.json, and this source is named openapi.json.

Fix: add the exact path to the docs patterns, and make the coverage test enumerate every SPEC_SOURCES entry so the next added source cannot slip past.

主要言語
Rust
スター
2
フォーク
0
平均マージ
10時間 45分
マージ済み PR(30日)
259

環境構築

はじめの一歩

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

registrystack/registry-stack のほかの issue

registrystack/registry-stack の issue をすべて見る

似ている issue

Rust の issue をもっと見る

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

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