Versões e definições alternativas

Duas coisas diferentes na página de um componente se chamam versão, e elas são eixos separados. Esta página separa as duas e depois cobre a terceira relação que parece uma versão e não é: a definição alternativa (alternative definition).

Leia se a página de um componente já mostrou Revision 1.0.0 ao lado de Applies to: Version 7 e você quer saber qual das duas está olhando. Para saber o que é um componente, veja Knowledge components.

Dois eixos, uma palavra

Eixo	Onde você vê	O que registra
Linha principal	Applies to, e os cartões Versions de uma tecnologia	As linhas de lançamento da tecnologia
Revisão	Revision, ao lado do selo de tipo	Como este texto evoluiu

Um componente pode estar em Revision 3.0.0 e valer para Version 6 e Version 7. Nada liga os dois números.

Cuidado

Nunca leia um “version” solto no Fito sem decidir de qual eixo ele fala. A API é explícita: o parâmetro que restringe a uma linha principal é technologyVersion, enquanto o campo chamado version é a revisão.

Linhas principais

Uma linha principal (major line) é a versão da tecnologia que um componente descreve. O rótulo dela é a linha em si — 7, nunca 7.1.4.

Toda tecnologia tem pelo menos uma. Para uma ferramenta, o rótulo nomeia uma linha que quem mantém a tecnologia publicou, então ele pode em princípio ser conferido contra eles. Para uma prática, o rótulo é a numeração do próprio Fito e não corresponde a nada fora do Fito. Ninguém publicou uma “Arquitetura Hexagonal 1”.

Por causa disso, um rótulo nunca é conferido contra um registro externo, e dois rótulos nunca são comparados para descobrir qual é mais novo. A convenção é que uma prática nasce na versão 1, e nada no Fito obriga isso. Quem nomear a primeira linha como cockburn-2005 não quebra nada.

Cada linha principal carrega as notas dela, e o que essas notas guardam muda conforme o tipo:

• Numa ferramenta, elas carregam o que é verdade em uma linha só: “Javalin 7 requires Java 17+ and runs on the embedded Jetty 12 server.”
• Numa prática, elas registram a formulação de origem em que os componentes se apoiam: “Cockburn’s 2005 formulation of Ports & Adapters.”

Essa segunda leitura é o que faz uma futura segunda linha significar algo. Quando a linha 1 diz qual formulação ela é, uma releitura posterior tem de que ser diferente, em vez de chegar como um renomear sem explicação de algo que ninguém relançou.

Applies to

Um componente vale para uma ou mais linhas principais, e todas elas pertencem à mesma tecnologia. Essa regra é o que permite que um único slug de tecnologia fique dentro do id de referência do componente.

Uma ideia que vale em duas linhas é um componente com dois vínculos, não uma cópia. Você vê as duas pílulas sob Applies to, e o componente aparece nas listagens das duas linhas.

A exceção é a divergência de verdade. Quando um concept muda de forma incompatível entre linhas principais, a ponto de um texto só não conseguir cobrir as duas com honestidade, ele vira dois componentes sem nenhuma linha em comum. Eles não são ligados um ao outro. As linhas às quais cada um se aplica já carregam a distinção, e um vínculo não acrescentaria nada que você não veja.

Para ler uma tecnologia uma linha por vez, abra um cartão na seção Versions dela. Cada contagem e cada entrada da barra lateral na página que abrir cobrem só aquela linha, e um componente vivo apenas em outra linha aparece como ausente.

Revisões

A revisão de um componente é o histórico do texto dele. Ela aparece como Revision 1.0.0 ao lado do selo de tipo.

Um componente revisado é um componente novo, ligado ao que ele substitui — não uma sobrescrita. Então o histórico é auditável: nada que foi publicado é apagado por baixo de quem citou aquilo.

Abra o painel Version history no pé da página de um componente para percorrer essa corrente. A entrada que você está lendo aparece marcada como atual. Um painel com uma entrada só lê This is the first published version of this component.

Na barra lateral, um componente que uma revisão mais nova substituiu aparece marcado como replaced by revision 2.0.0.

Nota

Um componente substituído ainda vale a leitura, e chegar a um não é um caminho errado. Um caso publicado pode fixar um componente substituído como pré-requisito, e o caso continua apontando exatamente para o que fixou.

Definições alternativas

Uma definição alternativa é a mesma ideia registrada com outras palavras — por outro autor, ou para outro público. Ela é um componente próprio, com o seu próprio id de referência, ligado ao componente ao lado do qual fica.

Ela não é versão de nada. É um enquadramento irmão. Daí seguem duas coisas:

• Um componente e a definição alternativa dele descrevem a mesma ideia no mesmo momento. Nenhuma substitui a outra.
• Dois componentes que diferem porque a tecnologia mudou entre linhas principais não são definições alternativas. Esse caso está acima, em Applies to.

Abra o painel Alternative definitions para vê-las. Um painel vazio lê No alternative definitions have been published for this component.

O que vem a seguir

• Navegar pela área de conhecimento — restrinja uma tecnologia a uma linha principal e abra os painéis.
• Tecnologias, ferramentas e práticas — em que uma linha principal se apoia.