Sobre alterações significativas
Alterações significativas são quaisquer mudanças que possam exigir ação dos nossos integrantes. Dividimos essas alterações em duas categorias:
- Significativas: As alterações que irão modificar as consultas existentes na API do GraphQL. Por exemplo, a eliminação de um campo seria uma mudança decisiva.
- Perigoso: Alterações que não modificam as consultas existentes, mas podem afetar o comportamento de tempo de execução dos clientes. Adicionar um valor de enumerador é um exemplo de uma alteração perigosa.
Nós nos esforçamos para fornecer APIs estáveis para os nossos integrantes. Quando um novo recurso ainda está evoluindo, o lançamos atrás de uma pré-visualização de esquema.
Vamos anunciar as próximas mudanças significativas em andamento pelo menos três meses antes de fazer alterações no esquema do GraphQL para dar tempo aos integradores de fazer os ajustes necessários. As alterações entram em vigor no primeiro dia do trimestre (1 de janeiro, 1 de abril, 1 de julho ou 1 de outubro). Por exemplo, se anunciarmos uma mudança no dia 15 de Janeiro, ela entrará em vigor no dia 1 de julho.
Alterações agendadas para 2021-01-01
- SubstancialSerá feita uma mudança em
EnterprisePendingCollaboratorEdge.isUnlicensed
.Descrição:
isUnlicensed
will be removed.Motivo:
All pending collaborators consume a license
- SubstancialSerá feita uma mudança em
EnterpriseOutsideCollaboratorEdge.isUnlicensed
.Descrição:
isUnlicensed
will be removed.Motivo:
All outside collaborators consume a license
- SubstancialSerá feita uma mudança em
EnterpriseMemberEdge.isUnlicensed
.Descrição:
isUnlicensed
will be removed.Motivo:
All members consume a license
Alterações agendadas para 2020-10-01
- SubstancialSerá feita uma mudança em
TeamRepositoryEdge.permission
.Descrição:
Type for
permission
will change fromRepositoryPermission!
toString
.Motivo:
This field may return additional values
- SubstancialSerá feita uma mudança em
Sponsorship.sponsor
.Descrição:
sponsor
will be removed. UseSponsorship.sponsorEntity
instead.Motivo:
Sponsorship.sponsor
will be removed.
- SubstancialSerá feita uma mudança em
RepositoryInvitationOrderField.INVITEE_LOGIN
.Descrição:
INVITEE_LOGIN
will be removed.Motivo:
INVITEE_LOGIN
is no longer a valid field value. Repository invitations can now be associated with an email, not only an invitee.
- SubstancialSerá feita uma mudança em
RepositoryInvitation.permission
.Descrição:
Type for
permission
will change fromRepositoryPermission!
toString
.Motivo:
This field may return additional values
- SubstancialSerá feita uma mudança em
RepositoryCollaboratorEdge.permission
.Descrição:
Type for
permission
will change fromRepositoryPermission!
toString
.Motivo:
This field may return additional values
- SubstancialSerá feita uma mudança em
PullRequest.timeline
.Descrição:
timeline
will be removed. Use PullRequest.timelineItems instead.Motivo:
timeline
will be removed
- SubstancialSerá feita uma mudança em
Issue.timeline
.Descrição:
timeline
will be removed. Use Issue.timelineItems instead.Motivo:
timeline
will be removed
- SubstancialSerá feita uma mudança em
EnterpriseOwnerInfo.pendingCollaborators
.Descrição:
pendingCollaborators
will be removed. Use thependingCollaboratorInvitations
field instead.Motivo:
Repository invitations can now be associated with an email, not only an invitee.
Alterações agendadas para 2020-07-01
- SubstancialSerá feita uma mudança em
EnterprisePendingMemberInvitationEdge.isUnlicensed
.Descrição:
isUnlicensed
will be removed.Motivo:
All pending members consume a license
Alterações agendadas para 2020-04-01
- SubstancialSerá feita uma mudança em
Sponsorship.maintainer
.Descrição:
maintainer
will be removed. UseSponsorship.sponsorable
instead.Motivo:
Sponsorship.maintainer
will be removed.
Alterações agendadas para 2020-01-01
- SubstancialSerá feita uma mudança em
UnassignedEvent.user
.Descrição:
user
will be removed. Use theassignee
field instead.Motivo:
Assignees can now be mannequins.
- SubstancialSerá feita uma mudança em
EnterpriseBillingInfo.seats
.Descrição:
seats
will be removed. Use EnterpriseBillingInfo.totalLicenses instead.Motivo:
seats
will be replaced withtotalLicenses
to provide more clarity on the value being returned
- SubstancialSerá feita uma mudança em
EnterpriseBillingInfo.availableSeats
.Descrição:
availableSeats
will be removed. Use EnterpriseBillingInfo.totalAvailableLicenses instead.Motivo:
availableSeats
will be replaced withtotalAvailableLicenses
to provide more clarity on the value being returned
- SubstancialSerá feita uma mudança em
AssignedEvent.user
.Descrição:
user
will be removed. Use theassignee
field instead.Motivo:
Assignees can now be mannequins.
Alterações agendadas para 2019-04-01
- SubstancialSerá feita uma mudança em
Migration.uploadUrlTemplate
.Descrição:
uploadUrlTemplate
will be removed. UseuploadUrl
instead.Motivo:
uploadUrlTemplate
is being removed because it is not a standard URL and adds an extra user step.