Cambios sustanciales

Acerca de los cambios sustanciales

Los cambios sustanciales son aquellos que pudieran necesitar que nuestros integradores realicen alguna acción al respecto. Dividimos estos cambios en dos categorías:

• Sustanciales: Cambios que modificarán consultas existentes a la API de GraphQL. Por ejemplo, eliminar un campo sería un cambio sustancial.
• Peligrosos: Cambios que no modificaran las consultas existentes, pero podrían afectar el comportamiento del tiempo de ejecución de los clientes. Agregar un valor de enumerador es un ejemplo de un cambio peligroso.

Nos esforzamos por proporcionar API estables para nuestros integradores. Cuando alguna característica nueva está evolucionando aún, la lanzamos detrás de una vista previa del modelo.

Anunciaremos los cambios sustanciales por venir por lo menos tres meses antes de aplicarlos al modelo de GraphQL, para proporcionar a los integradores tiempo para realizar los ajustes necesarios. Los cambios toman efecto en el primer día de un trimestre (1 de enero, 1 de abril, 1 de julio, o 1 de octubre). Por ejemplo, si anunciamos un cambio en el 15 de enero, se aplicará en el 1 de julio.

Cambios programados para 2019-04-01

• SustancialSe hará un cambio a Migration.uploadUrlTemplate.

  Descripción:

  uploadUrlTemplate will be removed. Use uploadUrl instead.

  Razón:

  uploadUrlTemplate is being removed because it is not a standard URL and adds an extra user step.

• SustancialSe hará un cambio a Organization.members.

  Descripción:

  members will be removed. Use Organization.membersWithRole instead.

  Razón:

  The members field is deprecated and will be removed soon.

Cambios programados para 2019-07-01

• SustancialSe hará un cambio a ContributionsCollection.firstIssueContribution.ignoreTimeRange.

  Descripción:

  ignoreTimeRange will be removed. Use a ContributionsCollection starting sufficiently far back

  Razón:

  ignore_time_range will be removed

• SustancialSe hará un cambio a ContributionsCollection.firstPullRequestContribution.ignoreTimeRange.

  Descripción:

  ignoreTimeRange will be removed. Use a ContributionsCollection starting sufficiently far back

  Razón:

  ignore_time_range will be removed

• SustancialSe hará un cambio a ContributionsCollection.firstRepositoryContribution.ignoreTimeRange.

  Descripción:

  ignoreTimeRange will be removed. Use a ContributionsCollection starting sufficiently far back

  Razón:

  ignore_time_range will be removed

• SustancialSe hará un cambio a ContributionsCollection.joinedGitHubContribution.ignoreTimeRange.

  Descripción:

  ignoreTimeRange will be removed. Use a ContributionsCollection starting sufficiently far back

  Razón:

  ignore_time_range will be removed

• SustancialSe hará un cambio a ReviewDismissedEvent.message.

  Descripción:

  message will be removed. Use dismissalMessage instead.

  Razón:

  message is being removed because it not nullable, whereas the underlying field is optional.

• SustancialSe hará un cambio a ReviewDismissedEvent.messageHtml.

  Descripción:

  messageHtml will be removed. Use dismissalMessageHTML instead.

  Razón:

  messageHtml is being removed because it not nullable, whereas the underlying field is optional.

Cambios programados para 2019-10-01

• SustancialSe hará un cambio a ContributionOrder.field.

  Descripción:

  field will be removed. Only one order field is supported.

  Razón:

  field will be removed.

• SustancialSe hará un cambio a Issue.timeline.

  Descripción:

  timeline will be removed. Use Issue.timelineItems instead.

  Razón:

  timeline will be removed

• SustancialSe hará un cambio a Organization.pinnedRepositories.

  Descripción:

  pinnedRepositories will be removed. Use ProfileOwner.pinnedItems instead.

  Razón:

  pinnedRepositories will be removed

• SustancialSe hará un cambio a PullRequest.timeline.

  Descripción:

  timeline will be removed. Use PullRequest.timelineItems instead.

  Razón:

  timeline will be removed

• SustancialSe hará un cambio a RepositoryOwner.pinnedRepositories.

  Descripción:

  pinnedRepositories will be removed. Use ProfileOwner.pinnedItems instead.

  Razón:

  pinnedRepositories will be removed

• SustancialSe hará un cambio a User.pinnedRepositories.

  Descripción:

  pinnedRepositories will be removed. Use ProfileOwner.pinnedItems instead.

  Razón:

  pinnedRepositories will be removed