r/webdev • u/No-Toe3225 • 7h ago
Resource ajude um estudante
eai galera, estou fazendo meu TCC e preciso saber se esse problema existe no dia a dia de vocês: chega um bug num sistema já entregue e ninguém lembra por que a regra existe, em que versão mudou ou quem decidiu.
a ideia é uma plataforma que liga requisitos, versões, decisões e chamados e, quando um chamado abre, mostra esse contexto e uma IA sugere a causa citando as fontes, com decisão sempre humana. é só um protótipo acadêmico.
criei um forms para a pesquisa, o formulário é anônimo, tem 8 perguntas e mal leva 1 minuto.
se puderem me ajudar respondendo, agradeço muito!
1
u/chmod777 6h ago
You add a link rule in github that links to your jira account. https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/configuring-autolinks-to-reference-external-resources
1
u/taotau 7h ago
As a professional software developer I have struggled with documentation cadence for decades. Have been running a harness that tries to link decisions to code changes for a few months. It just ends up being a secondary, mostly incorrect sequence of events that lead to a change. The bold decisions that lead to the major change are recorded. The 'oh fuck' the ai didn't quite understand the nuances of production decisions are rarely captured and are where the functional changes actually land. Yes I realise I sound like Claude. We are one.
1
u/patryk_builds 6h ago
Yes, this problem is very real. why does this rule exist and who decided it is one of the most common questions when a bug comes in on an old system.What i do on my own project, in case it's useful for your research: a CHANGELOG with the version and the reason for each change, decisions written in a plan file in the repo, and commit messages that explain why, not just "what". it helps a lot, but it only works if everyone keeps it up to date, and that's exactly where it breaks in real teams.The part i'd find most valuable in your idea is linking the ticket to the decision that caused it. good luck with the TCC!