# Análise de Código com \`very\_good\_analysis\`

Estamos substituindo o linter padrão do Flutter pelo pacote [`very_good_analysis`](https://pub.dev/packages/very_good_analysis), desenvolvido e mantido pela [Very Good Ventures](https://verygood.ventures/), uma das principais referências no ecossistema Flutter.

#### 🎯 Motivos da escolha

* **Padrões sólidos e consolidados:** o pacote oferece um conjunto de regras mais rigoroso e abrangente do que o padrão do Flutter, com foco em legibilidade, boas práticas e manutenibilidade.
* **Adoção por grandes projetos:** muitas iniciativas de código aberto e empresas referência utilizam esse linter, o que aumenta a confiança nas regras aplicadas.
* **Atualizações frequentes:** o pacote é mantido ativamente e evolui junto com o ecossistema do Dart/Flutter.
* **Redução de decisões subjetivas:** aplicar um linter opinativo evita discussões manuais sobre estilo de código e favorece decisões automatizadas e imparciais.

> O conjunto completo de regras utilizadas no pacote pode ser consultado no [`repositório do projeto`](https://github.com/VeryGoodOpenSource/very_good_analysis/blob/main/lib/analysis_options.9.0.0.yaml)

#### ⚙️ Como configurar

Adicione ao seu `pubspec.yaml`:

```yaml
dev_dependencies:  
	very_good_analysis:  ^9.0.0
```

Depois, no seu `analysis_options.yaml`:

```yaml
include: package:very_good_analysis/analysis_options.yaml
```

#### 🚫 Como desabilitar regras específicas

Você pode sobrescrever ou desativar regras que não façam sentido para seu projeto.\
Exemplo: desativar a exigência de documentação pública para membros públicos (`public_member_api_docs`):

```yaml
include: package:package:very_good_analysis/analysis_options.yaml  

linter:
	rules:
		public_member_api_docs: ignore
```

> ✅ Use com cautela: desabilitar muitas regras pode enfraquecer o objetivo do linter.
