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 2021-01-01
- SustancialSe hará un cambio a
EnterprisePendingCollaboratorEdge.isUnlicensed
.Descripción:
isUnlicensed
will be removed.Razón:
All pending collaborators consume a license
- SustancialSe hará un cambio a
EnterpriseOutsideCollaboratorEdge.isUnlicensed
.Descripción:
isUnlicensed
will be removed.Razón:
All outside collaborators consume a license
- SustancialSe hará un cambio a
EnterpriseMemberEdge.isUnlicensed
.Descripción:
isUnlicensed
will be removed.Razón:
All members consume a license
Cambios programados para 2020-10-01
- SustancialSe hará un cambio a
TeamRepositoryEdge.permission
.Descripción:
Type for
permission
will change fromRepositoryPermission!
toString
.Razón:
This field may return additional values
- SustancialSe hará un cambio a
Sponsorship.sponsor
.Descripción:
sponsor
will be removed. UseSponsorship.sponsorEntity
instead.Razón:
Sponsorship.sponsor
will be removed.
- SustancialSe hará un cambio a
RepositoryInvitationOrderField.INVITEE_LOGIN
.Descripción:
INVITEE_LOGIN
will be removed.Razón:
INVITEE_LOGIN
is no longer a valid field value. Repository invitations can now be associated with an email, not only an invitee.
- SustancialSe hará un cambio a
RepositoryInvitation.permission
.Descripción:
Type for
permission
will change fromRepositoryPermission!
toString
.Razón:
This field may return additional values
- SustancialSe hará un cambio a
RepositoryCollaboratorEdge.permission
.Descripción:
Type for
permission
will change fromRepositoryPermission!
toString
.Razón:
This field may return additional values
- 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
Issue.timeline
.Descripción:
timeline
will be removed. Use Issue.timelineItems instead.Razón:
timeline
will be removed
- SustancialSe hará un cambio a
EnterpriseOwnerInfo.pendingCollaborators
.Descripción:
pendingCollaborators
will be removed. Use thependingCollaboratorInvitations
field instead.Razón:
Repository invitations can now be associated with an email, not only an invitee.
Cambios programados para 2020-07-01
- SustancialSe hará un cambio a
EnterprisePendingMemberInvitationEdge.isUnlicensed
.Descripción:
isUnlicensed
will be removed.Razón:
All pending members consume a license
Cambios programados para 2020-04-01
- SustancialSe hará un cambio a
Sponsorship.maintainer
.Descripción:
maintainer
will be removed. UseSponsorship.sponsorable
instead.Razón:
Sponsorship.maintainer
will be removed.
Cambios programados para 2020-01-01
- SustancialSe hará un cambio a
UnassignedEvent.user
.Descripción:
user
will be removed. Use theassignee
field instead.Razón:
Assignees can now be mannequins.
- SustancialSe hará un cambio a
EnterpriseBillingInfo.seats
.Descripción:
seats
will be removed. Use EnterpriseBillingInfo.totalLicenses instead.Razón:
seats
will be replaced withtotalLicenses
to provide more clarity on the value being returned
- SustancialSe hará un cambio a
EnterpriseBillingInfo.availableSeats
.Descripción:
availableSeats
will be removed. Use EnterpriseBillingInfo.totalAvailableLicenses instead.Razón:
availableSeats
will be replaced withtotalAvailableLicenses
to provide more clarity on the value being returned
- SustancialSe hará un cambio a
AssignedEvent.user
.Descripción:
user
will be removed. Use theassignee
field instead.Razón:
Assignees can now be mannequins.
Cambios programados para 2019-04-01
- SustancialSe hará un cambio a
Migration.uploadUrlTemplate
.Descripción:
uploadUrlTemplate
will be removed. UseuploadUrl
instead.Razón:
uploadUrlTemplate
is being removed because it is not a standard URL and adds an extra user step.