Live data from Hacker News

Show HN: I built an AI that turns GitHub codebases into easy tutorials

github.com

31–40 of 181 posts

Re: Show HN: I built an AI that turns GitHub codebases into easy tutorials

#32
Really nice work and thank you for sharing. These are great demonstrations of the value of LLMs which help to go against the negative view on the impacts to junior engineers. This helps bridge the gap of most projects lacking updated documentation.

Re: Show HN: I built an AI that turns GitHub codebases into easy tutorials

#34
This is actually really cool. I just tried it out using an AI studio API key and was pretty impressed. One issue I noticed was that the output was a little too much "for dummies". Spending paragraphs to explain what an API is through restaurant analogies is a little unnecessary. And then followed up with more paragraphs on what GraphQL is. Every chapter seems to suffer from this. The generated documentation seems more suited for a slightly technical PM moreso than a software engineer. This can probably be mitigated by refining the prompt.

The prompt would also maybe be better if it encouraged variety in diagrams. For somethings, a flow chart would fit better than a sequence diagram (e.g., a durable state machine workflow written using AWS Step Functions).

Re: Show HN: I built an AI that turns GitHub codebases into easy tutorials

#36
post #34

This is actually really cool. I just tried it out using an AI studio API key and was pretty impressed. One issue I noticed was that the output was a little too much "for dummies". Spending paragraphs to explain what an API is through restaurant analogies is a little unnecessary. And then followed up with more paragraphs on what GraphQL is. Every chapter seems to suffer from this. The generated documentation seems mor…

exactly it is. I'd rather impressive but at the same time the audience is always going to be engineers, so perhaps it can be curated to still be technical to a degree? I can't imagine a scenario where I have to explain to the VP my ETL pipeline

Re: Show HN: I built an AI that turns GitHub codebases into easy tutorials

#37
post #33

For anyone doubting AI as pure hype, this is the counter example of its usefulness

Nobody said AI isn’t useful. The hype is that AI isn’t a tool but the developer.

I've seen a lot of developers that are absolute tools. But I've yet to see such a succinct use of AI. Kudos to the author.

Re: Show HN: I built an AI that turns GitHub codebases into easy tutorials

#38
post #33

Earlier quoted context omitted.

Nobody said AI isn’t useful. The hype is that AI isn’t a tool but the developer.

I've seen a lot of developers that are absolute tools. But I've yet to see such a succinct use of AI. Kudos to the author.

Exactly, kudos to the author because AI didn’t came up with that.

But that’s what they sell, that AI could do what the author did with AI.

The question is, is it worth to put all that money and energy in AI. MS sacrificed its CO2 goals for email summaries and better autocomplete not to mention all the useless things we do with AI

Re: Show HN: I built an AI that turns GitHub codebases into easy tutorials

#39
post #33

For anyone doubting AI as pure hype, this is the counter example of its usefulness

Nobody said AI isn’t useful. The hype is that AI isn’t a tool but the developer.

Nobody?

https://news.ycombinator.com/item?id=41542497

Re: Show HN: I built an AI that turns GitHub codebases into easy tutorials

#40
post #38

Earlier quoted context omitted.

I've seen a lot of developers that are absolute tools. But I've yet to see such a succinct use of AI. Kudos to the author.

Exactly, kudos to the author because AI didn’t came up with that. But that’s what they sell, that AI could do what the author did with AI. The question is, is it worth to put all that money and energy in AI. MS sacrificed its CO2 goals for email summaries and better autocomplete not to mention all the useless things we do with AI

> But that’s what they sell, that AI could do what the author did with AI.

Can you give an example of what you meant here? The author did use AI. What does "AI coming up with that" mean?

Post reply on HN