więc zszedłem w tę króliczą norę i to szalone, jak mało wiedziałem o praktykach dokumentacyjnych i ramach, a to wszystko nigdy nie jest wspomniane w rzeczywistych dokumentach ani w czymś, o czym zobaczysz duże kursy. arc42, modelowanie C4, Diátaxis to podejścia, których nigdy naprawdę nie widziałem, aby ludzie je wyraźnie praktykowali. większość baz kodu, które widziałem, miała bardzo ad-hoc dokumentację stworzoną jako myśl poboczna lub, z drugiej strony spektrum, została całkowicie uproszczona i zabstractyzowana przez doświadczonych pisarzy technicznych, więc niemożliwe było uchwycenie złożoności produktu poniżej samej powierzchni. mówiąc to, teraz pracuję nad własnym narzędziem do dokumentacji agentowej, które powinno zastosować niektóre z tych praktyk i utrzymywać spójną dokumentację dla kodów o wysokiej prędkości oraz być kompatybilne z wszelkimi rodzajami przepływów pracy w rozwoju, z możliwościami przetwarzania całych repozytoriów od podstaw i późniejszego ich utrzymywania poprzez przetwarzanie różnic git o dowolnym pochodzeniu.