Latest / Entre Chaves / Por que adotar (ou não) o ADR no meu projeto?

Transcript

Por que adotar (ou não) o ADR no meu projeto? · Entre Chaves

• 0:02
  Eu Acredito? Que tem que ir para uma Dr
• 0:04
  quando começa uma discussão muito grande.
• 0:06
  Então, por exemplo, a escolha da arquitetura em si, arquitetura
• 0:09
  em camadas ou outra arquitetura, não precisaria isso fosse um
• 0:13
  consenso geral. Então só uma documentação
• 0:15
  explicando essa arquitetura é ok.
• 0:18
  Agora, quando tem uma discussão muito grande de quais motivos
• 0:21
  para qual, aí eu acho que tem que levar para esse tipo de
• 0:24
  documentação para entender porque que houve uma discussão
• 0:27
  em primeiro lugar. Então que nem você falou da
• 0:29
  indentação, isso iria mais pra um cardline de de nem de
• 0:33
  variável ou coisas assim. E a arquitetura poderia ser só
• 0:36
  documentação. Então Eu Acredito que é quando
• 0:39
  surge essa discussão maior. Talvez acrescentando, colocaria
• 0:42
  também coisas que não são tão óbvias.
• 0:45
  Por exemplo, eu tenho uma tabela, por algum motivo ela ela
• 0:48
  tem a terceira forma normal aplicada, mas por algum motivo
• 0:51
  ela tem uma coluna que é redundante, parece trivial, mas
• 0:54
  assim, se existe uma normalização naquela tabela, eu
• 0:57
  eu vou queixar. Se tornar.
• 0:58
  Se eu ver uma duplicação e às vezes eu posso, eu mesma, sem
• 1:01
  querer, remover uma duplicação e eu travar 11 consulta e essa
• 1:05
  consulta levar parar de funcionar, sei lá.
• 1:08
  Por conta disso, acho que coisas não óbvias, não triviais.
• 1:10
  Acho que seria interessante coisas esquisitas.
• 1:13
  É igual? Esse eu acho.
• 1:16
  Que esquisito. É a melhor palavra?
• 1:18
  É. Não necessariamente é ruim, mas
• 1:20
  uma coisa é diferente do que. Tá no normal ali.
• 1:24
  Que todo mundo tá acostumado a ver, né?
• 1:25
  O que vai chamar atenção e falar, espera aí, tá um de
• 1:27
  errado aqui. Entende.
• 1:29
  Não de errado, mas tem algo que é um padrão que eu não.
• 1:31
  Reconheço o que é diferente de débito técnico, né?
• 1:33
  Exatamente. Tem um débito técnico, você vai
• 1:35
  lá? Não, cara.
• 1:35
  A gente sabe que isso aqui não é um código que tá tão bom e tal.
• 1:37
  A gente entende algumas coisas assim, EE vai, né?
• 1:41
  Mas é. Débito técnico tem que ir pro
• 1:43
  tem que ir pro gira, né? Exatamente, principalmente
• 1:44
  porque débito do técnico você costuma achar nos nos nos
• 1:48
  acompanhamentos de projeto, né? Essa gira Azure debops ou o que
• 1:50
  que seja, esqueci o nome desses sistemas?
• 1:52
  Mas, enfim, é algo assim. Pessoal, o que que vocês
• 1:55
  consideram uma má prática de de ADR?
• 1:58
  Ser prolix burro. Acho que a questão do ADR é você
• 2:02
  ser o mais claro e você ser o mais direto possível do que você
• 2:07
  tá pensando, pra justamente facilitar a discussão, assim,
• 2:12
  não não destoar muito do tópico mesmo, levar a discussão pra
• 2:16
  aquela decisão daquela, por exemplo, de uma tecnologia.
• 2:19
  X tipo aquilo que eu comentei, ele falei.
• 2:22
  Que eu perguntei, né? Não é pra ser uma redação do
• 2:24
  Enem então, né, é só pra falar cara, é isso, é isso por causa.
• 2:27
  Disso, por causa disso, a confiança do time assim e foi
• 2:31
  considerado pensando nisso, nisso e aquilo.
• 2:34
  Legal você ser direto. Essa sim, acho que é a base da
• 2:37
  Dr. Boa. Talvez seja um pouco abstrato,
• 2:39
  mas é. Eu já lidei com uma situação em
• 2:42
  que a gente teve um randover de um projeto, né?
• 2:44
  Um time que absorveu um projeto de outro time.
• 2:47
  E tinha 11 lista de ADRs nesse projeto, mas eu senti sabe que
• 2:54
  faltou detalhe de contexto, que tudo bem, é importante você não
• 2:57
  ser prolixo, mas é você bate o olho ali e você, beleza, quer
• 3:02
  entender um pouco mais Oo contexto daquela decisão?
• 3:06
  E aí não tem, só tem informações que são são ali soltas e eu
• 3:11
  senti que não foi muito útil. Sabe que eu precisei de pegar um
• 3:14
  contexto antes para entender o porquê que.
• 3:16
  Aquela decisão foi necessária, que problema aconteceu?
• 3:20
  Que essa decisão foi necessária, sabe?
• 3:22
  Então acho que é um trade off, né?
• 3:23
  Você não pode ser prolixo, mas eu acho que é legal você seguir
• 3:26
  essa pirâmide invertida e colocando alguns detalhes, ou
• 3:29
  até você linkando um a Dr no outro, né?
• 3:32
  Eu acho que isso é é uma. Prática também, entendendo assim
• 3:38
  se vai criar uma nova discussão a partir de uma Dr, avaliar se
• 3:42
  aquilo compensa mesmo virar uma Dr ou.
• 3:45
  Ou se descarta ou se vai para uma guideline mais nesse
• 3:49
  sentido, facilitando mesmo as discussões e não tornando aquilo
• 3:53
  uma coisa muito difícil de ler. Algo muito complexo é ter esse
• 3:56
  Balanço mesmo tanto da da descrição, não tão assim,
• 4:01
  extremamente detalhada, mas não algo tão, tão simples.
• 4:04
  Né? Legal.
• 4:05
  Eu acho que entra muito aquilo que você falou, né, Júlia?
• 4:08
  Tipo, cara, se algo não tá dando discussão, não tem porque ser
• 4:10
  uma Dr também, sabe? Então eu participei de um
• 4:12
  projeto também, que o pessoal falou, Ah, não vamos discutir,
• 4:14
  fazer ADR. Então cada um do time ficou responsável por um ADR.
• 4:17
  Então cada um ficava dentro daquele seu contexto e fazia
• 4:19
  aquilo. E nas deles a gente só falava,
• 4:22
  Ah, ouvi essa parte, ouviram depois, mas fiz essa parte da
• 4:24
  Dr. Eu fiz essa Dr, não sei o que tipo assim, depois que
• 4:27
  aquela pessoa tinha meio que definido, aí ela chegava e pedia
• 4:30
  para o pessoal. Comentar alguma coisa?
• 4:32
  Geralmente o pessoal só Ah, OK, então não tinha discussão.
• 4:35
  Era basicamente a definição arquitetural é que virava tipo
• 4:37
  uma Dr para tudo. Aí tinha uma cambada de ADR lá
• 4:40
  Na Na lista do do guet. Lá é perde a motivação da Dr,
• 4:43
  que é documentar as decisões em grupo, né?
• 4:46
  Não é só a pessoa fazer. E às vezes, levando até essa
• 4:49
  questão da falta de contexto, né, que a Rafa vivenciou, não
• 4:52
  tendo uma discussão ali, esse tipo de coisa.
• 4:54
  Eu acho que muito da Dr é você ser conciso e você levar a
• 4:59
  discussão. Acho que é.
• 5:00
  Principal assim é a é a base de tudo.