15:[[43218077,{"by":"thngs","descendants":1,"id":43218077,"kids":[43218130],"score":2,"text":"Hey HN,

I was an architect in a big tech company for years and worked with a lot of different teams, worked on a lot of different codebases all with varying degrees of documentation and complexity. What me and the team at Komment have tried to build is a way to make sense of projects, whether it's something we've built or others or something we've to get our heads around.

It:

- connects to a Git repo

- processes the codebase with a combination of deterministic exploration, static analysis and dependency graph generation

- Uses a few different LLMs (depending on language, purpose, etc.) to generate a structured wiki with architecture diagrams, usage examples and external dependencies.

Our current thinking is that it would be useful for agencies who have to produce documentation for clients or for clients who receive delivery of external code but if you have any other ideas, I would love to hear them!

Open to feedback, skepticism, and ideas on making this better.","time":1740826538,"title":"Show HN: Komment – make sense of messy codebases","type":"story","url":"https://www.komment.ai/"}],[41415619,{"by":"albingroen","descendants":46,"id":41415619,"kids":[41416417,41416411,41415956,41416129,41415946,41416078,41416067,41415897,41416343,41416636,41415902,41416154,41415760,41416418,41415984,41440328,41416262,41441644,41416540,41416064,41416060,41416057,41439666,41415998,41415972,41416528,41416454,41445246,41436065,41425326,41416287,41445253],"score":50,"text":"Have you worked at a company where it was easy to get up and running as a new hire? Where it was easy to find instructions on setting up your development environment, how to do database migrations, seed data, or how to get access to AWS?

In my experience, this process is always subpar. There is no clear place to find documentation; even if it's there, it's often outdated.

I've been thinking about this for a while, and I feel like writing, reading, and maintaining documentation could get much smoother and, frankly, more fun!

Do you have any ideas on how to improve it all?","time":1725185035,"title":"Ask HN: How To: Internal Documentation?","type":"story"}]]

user:	adisin3
created:	September 1, 2024
karma:	3