O controle de versão contemplará 4 tipos de lançamento (p.ex. major, minor, patch e release candidate) e terá prazos definidos para lançamento e implementação de novas versões major, bem como suporte de versões anteriores.
No link Anexo: Guia de Versionamento, integrante desta documentação, estão documentados os casos previstos em que uma nova versão de API poderá vir a quebrar o contrato estabelecido
Major: inclui novas características da implementação, mudanças, correções a serem incorporadas e que poderão vir a quebrar o contrato.
P.ex. v1.0.0, v2.0.0.
Minor: pequenas mudanças nos elementos já existentes, com manutenção da compatibilidade e sem quebra de contrato.
P.ex. v1.1.0, v1.2.0
Patch: esclarecimentos às especificações publicadas pelo diretório, não incluem alterações funcionais.
P.ex. v1.1.1, v1.1.2
Release candidate: versões de pré-lançamento de qualquer patch futuro, minor ou major.
P.ex. v1.0.0-rc , v1.0.0-rc2
O versionamento terá o seguinte formato, contemplando 4 tipos de lançamentos de versões: 1.12.2.rc1 - significando versão major 1, versão minor 12 , aplicação de patchs versão 2 e release candidate 1.
Será definido um cronograma de novas versões dos padrões para que os participantes consigam se planejar e desenvolver novas APIs, com cada um dos lançamentos tendo um prazo pré-estabelecido para ser implementado pelos participantes, mitigando, desta forma, o risco de múltiplas versões.
...