破壊的変更

破壊的変更について

破壊的変更は、インテグレーターからのアクションが必要になるかもしれない変更です。 これらの変更は、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. Use uploadUrl 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 the assignee field instead.

  理由：

  Assignees can now be mannequins.

• 破壊的変更がUnassignedEvent.userに対して行われます。

  説明：

  user will be removed. Use the assignee field instead.

  理由：

  Assignees can now be mannequins.