TerraLib and TerraView Wiki Page

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
wiki:documentation:devguide:versioning [2016/03/08 12:37]
gribeiro [Veja Também os Seguintes Documentos]
wiki:documentation:devguide:versioning [2016/03/08 12:40]
gribeiro [Veja Também os Seguintes Documentos]
Line 10: Line 10:
 As versões estáveis são numeradas usando-se a tripla //​**x.y.z**//,​ que indica, respectivamente,​ os números conhecidos por //Major Version//, //Minor Version// e //Patch Version// (ou //revision number//). As versões estáveis são numeradas usando-se a tripla //​**x.y.z**//,​ que indica, respectivamente,​ os números conhecidos por //Major Version//, //Minor Version// e //Patch Version// (ou //revision number//).
  
-A numeração **x** é usada para separar versões bem diferentes e que, geralmente, indicam uma grande mudança na API. Mudanças neste nível podem implicar desde a adição de um grande número de funcionalidades até saltos tecnológicos que culminem no rompimento total da API. Em resumo, os desenvolvedores,​ clientes da API TerraMA2, podem esperar mudanças significativas da API.+A numeração **x** é usada para separar versões bem diferentes e que, geralmente, indicam uma grande mudança na API. Mudanças neste nível podem implicar desde a adição de um grande número de funcionalidades até saltos tecnológicos que culminem no rompimento total da API. Em resumo, os desenvolvedores,​ clientes da API TerraLib, podem esperar mudanças significativas da API.
  
 A numeração **y** é usada para separar versões que adicionam novas funcionalidades,​ mas que não trazem grandes impactos nas aplicações existentes. Mudanças neste nível não devem acarretar incompatibilidades entre as APIs. Obviamente, o uso de recursos da nova versão farão com que o cliente não possa fazer a atualização para baixo novamente sem um mínimo de esforço de programação. A numeração **y** é usada para separar versões que adicionam novas funcionalidades,​ mas que não trazem grandes impactos nas aplicações existentes. Mudanças neste nível não devem acarretar incompatibilidades entre as APIs. Obviamente, o uso de recursos da nova versão farão com que o cliente não possa fazer a atualização para baixo novamente sem um mínimo de esforço de programação.
Line 17: Line 17:
  
 As versões de **pré-lançamento** (//​instáveis//​ ou //​experimentais//​) possuem um qualificador extra, um sufixo da forma: //​**-tipo-pré-lançamento.w**//​. Até que uma versão atinja um ponto estável, passando por todos os testes de aceitação,​ esta versão passará, na ordem, pelos seguintes estados: As versões de **pré-lançamento** (//​instáveis//​ ou //​experimentais//​) possuem um qualificador extra, um sufixo da forma: //​**-tipo-pré-lançamento.w**//​. Até que uma versão atinja um ponto estável, passando por todos os testes de aceitação,​ esta versão passará, na ordem, pelos seguintes estados:
-  * **alpha.w:​** a qualificação //alpha// é reservada para geração de versões preliminares que possam ser usadas por colaboradores e usuários que tenham produtos baseados no TerraMA2 ​e que tenham a necessidade de acompanhar os lançamentos mais recentes.+  * **alpha.w:​** a qualificação //alpha// é reservada para geração de versões preliminares que possam ser usadas por colaboradores e usuários que tenham produtos baseados no TerraLib ​e que tenham a necessidade de acompanhar os lançamentos mais recentes.
   * **beta.w:** a qualificação //beta// indica que é um produto que já pode ser testado pelos colaboradores e usuários.   * **beta.w:** a qualificação //beta// indica que é um produto que já pode ser testado pelos colaboradores e usuários.
   * **rc.w:** a qualificação //release candidate// indica que o produto já se encontra em um nível próximo de ser aceito, mas que ainda pode sofrer modificações devido a correções.   * **rc.w:** a qualificação //release candidate// indica que o produto já se encontra em um nível próximo de ser aceito, mas que ainda pode sofrer modificações devido a correções.
Line 70: Line 70:
   * [[http://​semver.org|Semantic Versioning 2.0.0]].   * [[http://​semver.org|Semantic Versioning 2.0.0]].
  
 +  * [[http://​en.wikipedia.org/​wiki/​Software_versioning|Software Versioning]].
 +
 +  * [[http://​en.wikipedia.org/​wiki/​Deprecation|Deprecation]].