Visão Geral
As configurações do Kodus funcionam em três níveis: Global, Repositório e Diretório.O nível mais específico prevalece: Diretório > Repositório > Global
Como Funciona
Os campos herdam do nível pai por padrão. Quando você altera um campo no Global, todos os repositórios e diretórios sem uma sobrescrita são atualizados automaticamente.As sobrescritas são por campo. Você pode sobrescrever um campo e herdar todo o resto.
No app
- Trocando de nível: o seletor de escopo no topo do grupo Code review da barra lateral lista Global (“applies to every repository”), depois cada repositório que tem sua própria configuração, com seus diretórios recuados abaixo. Trocar de escopo mantém você na mesma página (General, What to review, Kody Rules, What Kody writes).
- Adicionando um nível: no seletor de escopo, escolha Add repository configuration. O diálogo Create repository settings pede para você usar Select the target repository e, opcionalmente, Select the target directories; clique em Create settings. Veja Configurações por Diretório.
- Vendo as sobrescritas: um indicador numérico ao lado de um escopo ou página na barra lateral conta as configurações sobrescritas naquele nível (“N settings overridden at this level”). Na página, cada campo sobrescrito mostra um badge Overridden; o botão de desfazer dele devolve o campo à herança.
- Removendo um nível: o menu ⋯ ao lado do seletor de escopo tem Delete configuration (e Edit directories para um escopo de diretório).
Exemplos
- Alteração global se propaga
- Sobrescrita de repositório
- Retornar à herança
Você altera Minimum severity to post (em What to review) no Global.Todos os repositórios e diretórios sem uma sobrescrita são atualizados automaticamente. Os que têm sobrescrita permanecem inalterados.
Boas Práticas
- Comece no Global com padrões sólidos
- Sobrescreva apenas quando tiver uma necessidade específica para aquele repositório/diretório
Perguntas Frequentes
Se eu alterar algo no Global, isso vai quebrar meus ajustes locais?
Se eu alterar algo no Global, isso vai quebrar meus ajustes locais?
Não. As sobrescritas locais permanecem inalteradas.
Posso sobrescrever apenas um campo e herdar o restante?
Posso sobrescrever apenas um campo e herdar o restante?
Sim. As sobrescritas são por campo.
Um Diretório herda do Repositório ou do Global?
Um Diretório herda do Repositório ou do Global?
Do Repositório primeiro. Se o Repositório não tiver uma sobrescrita para aquele campo, herda do Global.