Na pequena série sobre o “Agile BA” eu prometi um post para falar especificamente sobre documentação – o 2º maior pesadelo dos programadores.
Nick Malik, do Inside Architecture, chegou antes, e no último dia 11/jul publicou 4 razões para não acreditarmos que código é documentação suficiente para processos de negócio.
O excelente artigo do Nick não me isentará de voltar ao assunto. Acontece que eu quero ir um pouco além, tentando entender ou explicar o trauma que é a tal “documentação”. Enquanto trato de outras prioridades, fica a provocação:
“Software is the leaky abstraction. It makes poor documentation for a business process.“


Eu ia té assinar o feed do cara mas essa afirmação:
“@Brian
“Show me a business process not documented in the code and I’ll show you an out of date, innacurate process documentation.”
And I will show you an organization at Level 1 of process maturity.”
É simplesmente ridÃcula. É só passear por empresas e cases de empresas com maturidade de processo (i.e. CMMi) e ver que é mentira. Acabo de concluir o phase-out de um sistema comprado de uma empresa com CMMi 5 e os Casos de Uso pararam de ser atualizados quando a empresa se deu conta que não conseguiria mantêr seu processo burocrático com tnatas mudanças de escopo. Um desastre completo, pelo menos para mim como cliente.
De qualquer modo bloguei sobre o tema:
[]s