[Possible Schema Inaccuracy] multiple PR fields have odd description

オープン

#691 2021年11月22日に作成コメント 2 件リアクション 0 件担当者 0 名 GitHub で見る

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

評価

難易度: 4/5
見積もり時間: 3〜5日
初心者へのやさしさ: 35/100

issue の種類: ドキュメント
明瞭さ: おおむね明確
活発さ: 停滞
技術スタック: openapi
領域: api, documentation

調査の方向性

まず "pull-request" レスポンス／スキーマを見つけ、mergeable、draft、rebaseable、mergeable_state の定義を確認します。それらの optional および nullable の挙動を GraphQL API の MergeStateStatus enum と比較します。スキーマがこれらの挙動を明確に文書化しているか、フィールドと enum 値を正確に表現していれば完了です。

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

説明

feature fundamentals-and-support inaccuracy P4 shield waiting for review

I'm not entirely sure that these are schema inaccuracies but multiple fields of PRs (specifically the "pull-request" response / schema) have an odd definition:

mergeable is a nullable boolean field,it is not otherwise documented, it's hard to fathom why a PR would be something other than "mergeable" and "not mergeable". Either the field should be marked required, or the behaviour should be explained (I guess "we don't know if it's mergeable yet" is possible but in that case why not just set it to non-mergeable?).
draft is somewhat similarly an optional boolean, it's not clear when it would be absent (possibly projects which don't support / allow draft PRs? still why have that in the response rather than just false?)
rebaseable is both nullable and optional, same remarks as above.
mergeable_state is completely undocumented aside from knowing it's a string. Looking at the GraphQL API, it the example value ("clean") matches the MergeStateStatus enum. If this is the right conversion, mergeable_state should be defined as an enum with those values provided (and documented as they are in the graphql schema, maybe).

主要言語: 言語のデータがありません
スター: 1.6k
フォーク: 342
平均マージ: 2時間 23分
マージ済み PR（30日）: 57

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

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

github/rest-api-description のほかの issue

[Schema Inaccuracy] Repository security advisory operations name `repository_advisories:read` / `repository_advisories:write` OAuth scopes that do not exist オープン

feature

難易度 2/5 1〜3時間初心者へのやさしさ 85/100

github/rest-api-description#7220 · 2026年9月22日に作成
[Schema Inaccuracy] Missing Link header from org/security-advisories response description オープン

feature

難易度 2/5 1〜3時間初心者へのやさしさ 82/100

github/rest-api-description#7201 · 2026年9月15日に作成
Runner deprecations: enterprise scope is in the changelog and the 404 handler but not in the description オープン

feature

難易度 2/5 1〜3時間初心者へのやさしさ 72/100

github/rest-api-description#7163 · 2026年9月9日に作成
Runner deprecations: registration_deprecates_at is declared on the response but never returned オープン

feature

難易度 2/5 1〜3時間初心者へのやさしさ 68/100

github/rest-api-description#7162 · 2026年9月9日に作成
configure-pages API endpoint yields anchor that doesn't exist in docs オープン

feature

難易度 2/5 1〜3時間初心者へのやさしさ 68/100

github/rest-api-description#7135 · 2026年9月4日に作成

github/rest-api-description の issue をすべて見る

似ている issue

Add full support for Excel and XML exports as email attachment オープン

Area: Excel support

難易度 2/5 1〜3時間初心者へのやさしさ 75/100

orbeon/orbeon-forms#7893 · 2026年9月23日に作成
[essnmx] Fix typo in NXLauetof application definition オープン

essnmx good first issue

難易度 1/5 1時間未満初心者へのやさしさ 95/100

scipp/ess#760 · 2026年9月23日に作成
`IOCExtractor` always fails: `ioc_analyzer.build()` takes 1 argument but the agent dispatcher passes 2 オープン

難易度 2/5 1〜3時間初心者へのやさしさ 75/100

yeti-platform/yeti#1380 · 2026年9月23日に作成
OAuth client scope handling breaks on comma-separated scope strings オープン

難易度 2/5 1〜3時間初心者へのやさしさ 75/100

modelcontextprotocol/python-sdk#3566 · 2026年9月23日に作成
Bedrock: every OpenAI GPT-6 Sol/Luna call fails with 400 because the default temperature is always sent オープン

難易度 2/5 1〜3時間初心者へのやさしさ 70/100

griptape-ai/griptape#2353 · 2026年9月23日に作成

Backend & API Design の issue をもっと見る

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