Versionamento
Correções em regras de lint, layouts de formatação, etc. podem prevenir que seus scripts passem. Dado a natureza dessas alterações,
é altamente recomendável salvar a versão exata em seu package.json
, ao invés de usar operadores de intervalo de versões.
Essa metodologia irá garantir que seus scripts não irão falhar inesperadamente.
Versionamento Semântico
Section titled Versionamento SemânticoO Biome segue o versionamento semântico. Dado a natureza do Biome como um conjunto de ferramentas, pode ser incerto quais mudanças são consideradas maior, menor, ou de correção. Isso é o porquê do Biome usar o seguinte guia de versionamento:
Lançamento de Correção
Section titled Lançamento de Correção- Corrigindo uma regra de lint que gera erros de lint para código válido (falsos positivos)
- Corrigindo sugestão de código incorreta
- Corrigindo a formatação de uma sintaxe que resulta em um código inválido ou altera a semântica do programa.
- Melhorias na documentação
- Mudanças internas que não afetam a funcionalidade do Biome:
- Refatorações
- Melhorias de performance
- Aumento ou alteração na cobertura de testes
- Melhorando a redação de diagnósticos ou corrigindo a renderização de diagnósticos
- Relançamentos após um lançamento falho
- Alterando a formatação de sintaxe estabelecida
Lançamento Menor
Section titled Lançamento Menor- Adicionando uma nova regra ou promovendo uma regra de lint existente para um grupo estável que não é recomendando por padrão.
- Adicionando suporte a linting e a formatação para uma funcionalidade de linguagem recentemente introduzida, mesmo que isso resulte em mais erros de linting reportados
- Remoção de regras recomendadas
- Descontinuação de regras existentes
- Adicionando novas opções de configuração opcionais que não alteram a formatação ou reportem mais erros de lint
- Adicionando uma nova regra de lint recomendada ou promovendo uma regra de lint existente do grupo experimental para uma regra de lint recomendada em um grupo estável
- Remoção de uma regra não-experimental ou rebaixando uma regra para o grupo experimental
Lançamento maior
Section titled Lançamento maior- Mudanças para a configuração que resulta em uma diferente formatação ou mais reportes de erros de lint (adicionando/removendo opções, alterando valor padrão)
- Mudanças para a API pública do Biome
- Promoção de novas funcionalidades ou ferramentas que precisam de algum destaque
Extensão do Visual Studio Code
Section titled Extensão do Visual Studio CodeO Visual Studio Code não suporta tags de pré-lançamento para extensões. Isso é o porquê o Biome usa o seguinte esquema para distinguir versões estáveis e prévias:
- Versões estáveis usam números de versão pares: 10, 12, 14, 16, …
- Versões prévias usam números de versão ímpares: 11, 13, 15, 17, …