破壊的変更について
破壊的変更は、インテグレーターからのアクションが必要になるかもしれない変更です。 これらの変更は、2つに分類されます。
- 破壊的: GraphQL APIに対する既存のクエリを損なう変更。 たとえば、フィールドの削除は破壊的変更です。
- 危険: 既存のクエリを損なうことはないものの、クライアントの実行時の振る舞いに影響するかもしれない変更です。 enum値の追加は危険な変更の例です。
私たちは、インテグレーターに安定したAPIを提供するよう努めています。 新しい機能が進化を続けている場合、それはスキーマプレビューの背後でリリースしています。
今後の破壊的変更のアナウンスは、遅くてもGraphQLスキーマに対して変更を行う3ヶ月前にアナウンスを行い、インテグレーターに必要な調整を行う時間を提供します。 変更は、四半期の初日(1月1日、4月1日、7月1日、10月1日)に適用されます。 たとえば、変更を1月115日にアナウンスした場合、その変更は7月1日に行われます。
2019-04-01にスケジュールされた変更
- 破壊的変更が
Migration.uploadUrlTemplate
に対して行われます。説明:
uploadUrlTemplate
will be removed. UseuploadUrl
instead.理由:
uploadUrlTemplate
is being removed because it is not a standard URL and adds an extra user step.
2019-10-01にスケジュールされた変更
- 破壊的変更が
ContributionOrder.field
に対して行われます。説明:
field
will be removed. Only one order field is supported.理由:
field
will be removed.
- 破壊的変更が
Issue.timeline
に対して行われます。説明:
timeline
will be removed. Use Issue.timelineItems instead.理由:
timeline
will be removed
- 破壊的変更が
Organization.pinnedRepositories
に対して行われます。説明:
pinnedRepositories
will be removed. Use ProfileOwner.pinnedItems instead.理由:
pinnedRepositories will be removed
- 破壊的変更が
PullRequest.timeline
に対して行われます。説明:
timeline
will be removed. Use PullRequest.timelineItems instead.理由:
timeline
will be removed
- 破壊的変更が
RepositoryOwner.pinnedRepositories
に対して行われます。説明:
pinnedRepositories
will be removed. Use ProfileOwner.pinnedItems instead.理由:
pinnedRepositories will be removed
- 破壊的変更が
User.pinnedRepositories
に対して行われます。説明:
pinnedRepositories
will be removed. Use ProfileOwner.pinnedItems instead.理由:
pinnedRepositories will be removed
2020-01-01にスケジュールされた変更
- 破壊的変更が
AssignedEvent.user
に対して行われます。説明:
user
will be removed. Use theassignee
field instead.理由:
Assignees can now be mannequins.
- 破壊的変更が
UnassignedEvent.user
に対して行われます。説明:
user
will be removed. Use theassignee
field instead.理由:
Assignees can now be mannequins.