Pular para o conteúdo

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.

O 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:

  • 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
  • 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
  • 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 Code

O 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, …