Uma regra aqui não é um conselho: ou tem alguém a aplicá-la, ou está marcada como promessa.
Quase toda a gente escreve regras para a sua empresa e quase ninguém as cumpre, porque uma regra escrita não faz nada por si. Fica num documento, é lida no primeiro mês, e a partir daí é o hábito que manda. Esta casa parte do princípio contrário: uma regra só vale o que a obriga a acontecer.
Por isso cada regra desta empresa tem de dizer três coisas antes de existir: o que exige, quem a faz cumprir, e como se prova que está a ser cumprida. Se não conseguir responder às três, não é uma regra — é uma intenção, e fica marcada como tal.
Aplicada ou declarada
Cada política tem um de dois estados, e a diferença é honesta em vez de ser confortável.
- Existe código que a impõe.
- Existe um teste que falha se alguém a partir.
- Não depende de ninguém se lembrar.
- Está escrita e é para valer.
- Ainda não há nada que a impeça de ser ignorada.
- Conta como trabalho por fazer, não como proteção.
Uma empresa que chama «aplicadas» às regras que só escreveu acredita estar protegida onde não está. O dia em que isso se descobre é sempre o pior dia possível. Marcar a diferença custa orgulho; escondê-la custa um cliente.
As três camadas
A governança desta casa está em três sítios diferentes, e é de propósito que não estão todos no mesmo.
- 1As políticas — os princípios grandes: o que precisa da tua aprovação, o que nunca pode ser gasto sem ti, o que tem de ficar registado. São poucas e mudam raramente.
- 2O corpo de regras — as regras concretas do trabalho do dia a dia, numeradas e versionadas, cada uma com o seu texto atual e todo o histórico. São muitas e mudam com o que a empresa aprende.
- 3Os travões — proteções que correm sozinhas, fora da conversa, e que dizem «não» sem pedir opinião a ninguém. São a última linha e são as únicas que não se conseguem convencer.
A ordem importa. As políticas dizem o que a casa quer, o corpo de regras diz como isso se faz, e os travões existem porque nem tudo o que está escrito é cumprido só por estar escrito.
O que isto te dá
- Podes ler qualquer regra sem abrir código.
- Podes ver, ao lado de cada uma, se ela está mesmo a proteger-te ou se ainda é só uma intenção.
- Podes mudar de ideias sobre uma regra e ver, no histórico, o que ela dizia antes e quando mudou.
- Ninguém — nem a empresa a si própria — consegue afrouxar uma regra em silêncio.
Onde isto é mesmo aplicado
- As políticas da casa, uma por ficheiro
policies/ - A tabela que diz o que aplica cada uma
policies/README.md
Este texto explica; aqueles ficheiros decidem. Se discordarem, é este texto que está errado.