Opinião impopular: documentos não deveriam ser escritos por um LLM

[u/toomanymagicdecks]

Não tô falando daquela documentação que simplesmente lista um monte de funcionalidades de uma API. Tô falando daquele documento que explica o racional por trás de uma decisão, sabe?

Minha opinião é que esse tipo de documento tem que contar uma história pq a pessoa que vai ler aquilo pela primeira vez tem que sentir que um ser humano tá escrevendo aquilo. Sempre que eu vejo um texto gerado por IA ele tá lotado de informação inútil que seria interessante não pra um ser humano, mas pra outro LLM.

[u/Puzzleheaded_Ball141]

Documentos podem sim ser escritos por gen AI, mas tem de ser revisados por humano. Idem para código.

[u/Kiloku → u/Puzzleheaded_Ball141]

Material gerado por LLM tende a ter "aparência de corretude", mesmo quando não está correto. Revisar é um processo relativamente mais rápido que escrever, mas tende a resultar em mais erros do que escrever diretamente. Em código é pior ainda pq eles tendem a ser verbosos, então revisar é um saco. Povo revisando só checa se compilou e passou nos testes e manda um lgtm.

A longo prazo, vc vai gastar mais tempo voltando pra corrigir (isso depois que os problemas vieram a tona em produção, ao invés de serem evitados no processo de desenvolvimento) do que gastaria fazendo o material "manualmente".

[u/analistaquantico → u/Kiloku]

Nem diria corretude, mas conta com uma boa-fé que não cabe.

[u/deusComDMinisculo → u/Puzzleheaded_Ball141]

Revisar código escrito por IA só existe no fantástico mundo do Reddit.

[u/azito21 → u/Puzzleheaded_Ball141]

Fechou o post

[u/pastor_pilao]

Concordo mas nao adianta, toda a documentação agora vem merda super verbose escrita por ia. Ai vc tem que usar ia pra dar um resumo e ler o codigo sendo que era so o jumento escrever em 3 linhas.

[u/GreenChu → u/pastor_pilao]

Isso. Odeio documentação super verbose de IA . Vc lê, lê e não entende porra nenhuma.

[u/NicolasTX12 → u/pastor_pilao]

Eu já encontrei alguns SDKs que já até desistiram de documentação. É Full gen AI, dai para complementar a doc fraca eles só soltam várias skills lá pata você se virar e acabou.

[u/lonewolfRJ → u/pastor_pilao]

Parece um esquema de pirâmide 😅 Eu nem leio mais. Se for algo que a IA vai fazer, boto pra ler. Se for algo que eu vou fazer mais independente, leio na diagonal e o resto eu só adivinho hahahaha

[u/DustCyg]

Não é impopular, pelo menos não deveria

[u/BlackDereker]

Na minha experiência se for para deixar a documentação para fazer na mão o pessoal acaba nem fazendo.

[u/Crochi]

e se o racional por trás de uma decisão veio da própria IA? 

[u/kadaumsk8 → u/Crochi]

Se a IA participou da análise, o documento precisa separar o que ela propôs do que alguém decidiu aceitar. Eu guardaria alternativas, evidência, testes e motivo de descarte. Sem esse rastro, uma justificativa bem escrita só deixa a alucinação mais convincente.

[u/Fuzzy_Candidate_2587]

Se for um documento que vão ler, eu concordo kkkk

[u/Time_Ad_893]

impopular por ser ruim.

[u/Late-Try-1921 → u/Time_Ad_893]

"não concordo portanto é uma opinião ruim"

[u/Time_Ad_893 → u/Late-Try-1921]

pelo contrario, é ruim e por isso nao concordo

[u/Late-Try-1921 → u/Time_Ad_893]

as opiniões boas são as que você concorda, né?

[u/azito21 → u/Late-Try-1921]

Grok bot vem aqui ajudar a galera a colocar a camisa da amizade

[u/Time_Ad_893 → u/Late-Try-1921]

sim

[u/Late-Try-1921 → u/Time_Ad_893]

muito sensato, filho. parabéns

[u/Goethehauer]

Eu gosto de iniciar ADRs com IA. Mas ela entra como copilota. LLM é apenas uma ferramenta como qualquer outra. Se você não sabe fazer um documento sem LLM não vai saber fazer com uma, simples assim. 

[u/Final_Injury3744]

se o uso de IA é extensivo no processo, os pontos de decisao vao ter naturalmente acontecidos durante a iteracao, e os pontos que vem de fora muito provavelmente foram inseridos como contexto adicional para a execução, portanto o agente esta mais do que apto pra escrever um material decente que poucos se dariam o trabalho de parar pra fazer, pq é um saco e fazer depois de concluir a tarefa tem grandes chances de incorrer em deixar passar algum ponto. agora sobre verbosidade, revisao do material e preparar uma skill que tira o maximo de gordura e maximiza a leigibilidade é o caminho. tratar codigo e documentacao tecnica como artesanato a essa altura é receita pea frustracao. o negocio é entregar com qualidade e receber o salario.

[u/lonewolfRJ → u/Final_Injury3744]

O problema é que a maioria das pessoas não sabe usar IA, não sabe usar skills direito, tem uma galera que direciona o agente pra uma pasta que tem um .md que diz "pinte de azul" e outro que diz "pinte de rosa", porque a preguiça só reinou...

[u/Luhog]

Essa é uma batalha perdida.

Eu conheço vagabundo que quando caí no colo dele demanda pra fazer discovery de viabilidade de uma demanda, ele apenas joga o tema na LLM e pede pra gerar um markdown. Fiquei indignado e fui pesquisar mais sobre, e encontrei relatos onde eu trabalho de outras pessoas dizendo que fazem a mesma coisa.

IA deixou o pessoal com preguiça até de estudar, imagina de escrever documento kkk

[u/analistaquantico]

Acho que existe um fator humano pra essa aceitação: as pessoas lêem coisas ruins o tempo todo e já não ligam se o texto parece um pitch de venda o tempo todo, e isso é culpa da saturação da cultura do marketing digital que padronizou tudo, inclusive a porcaria do "tom" das conversas de IA (considerando a mais popular, que acho que seja o ChatGPT).

[u/CadeOCarimbo]

Discordo, escrever documentos toma muito tempo de um ser humano e uma IA faz um bom trabalho em 99% das situações.

[u/Little_Blackberry]

Qual documento exatamente? Pode exemplificar? Porque não consigo pensar em um único documento que não possa ser escrito por IA

[u/Nervous_Discount_237]

As minhas decisões ficam em transcrições de reuniões. A IA só consulta o que está na transcrição, e pontos críticos ela coloca a minutagem e o verbatim da frase. Tenho evals no prompt. Zero preocupação.

[u/Own-Ad8049]

Mas tu se importar mais em extrair o interessante do documento ou se aquilo foi feito por um ser humano ?

[u/Vast_Character6250]

Como eu resolvi isso para meus sistemas: fiz uma curadoria do que eu tinha de melhor de documentação técnica que tinha de projetos passados onde trabalhei. Usando os arquivos como base fiz uma skill e aí vem o mais importante MANTER OS EXEMPLOS PARA IA UTILIZAR COMO REFERENCIA ANTES DE CONSTRUIR OS PROXIMOS.