nitro icon indicating copy to clipboard operation
nitro copied to clipboard

Add badge for DeepWiki to README

Open franklin-tina opened this issue 3 months ago โ€ข 9 comments

DeepWiki provides in-depth documentation for public (and, in some cases, private) repositories. Adding this badge ensures that the content is automatically refreshed and always stays up to date. See Nitro docs in DeepWiki

P.S. Rolldown and Hono are among the popular repositories adopting this as well.

๐Ÿ”— Linked issue

โ“ Type of change

  • [x] ๐Ÿ“– Documentation (updates to the documentation, readme, or JSdoc annotations)
  • [ ] ๐Ÿž Bug fix (a non-breaking change that fixes an issue)
  • [ ] ๐Ÿ‘Œ Enhancement (improving an existing functionality like performance)
  • [ ] โœจ New feature (a non-breaking change that adds functionality)
  • [ ] ๐Ÿงน Chore (updates to the build process or auxiliary tools and libraries)
  • [ ] โš ๏ธ Breaking change (fix or feature that would cause existing functionality to change)

๐Ÿ“š Description

๐Ÿ“ Checklist

  • [ ] I have linked an issue or discussion.
  • [ ] I have updated the documentation accordingly.

franklin-tina avatar Oct 17 '25 16:10 franklin-tina

@franklin-tina is attempting to deploy a commit to the Nitro Team on Vercel.

A member of the Team first needs to authorize it.

vercel[bot] avatar Oct 17 '25 16:10 vercel[bot]

Looks sick! I will review generated content once had little more time. We should add it for h3 too!

Small question: Is there a way to refine content if there was a mistake?

pi0 avatar Oct 18 '25 08:10 pi0

Small question: Is there a way to refine content if there was a mistake?

I'm not entirely sure, since all the documentation is generated from the available codebase. Definitely something to keep an eye out for.

But, the more up to date it is when the repo last indexed, the more accurate the generated docs will be.

franklin-tina avatar Oct 18 '25 08:10 franklin-tina

Looks sick! I will review generated content once had little more time. We should add it for h3 too!

Small question: Is there a way to refine content if there was a mistake?

There's only one way to fix it: force yourself to write detailed code comments for every prop or function.

Adding a badge automatically updates you weekly, but you'll need to pay for more frequent updates.

I'm using DeekWiki to write documentation instead of myself. But I've noticed that the documentation isn't updated regularly, forcing me to write a lot of meaningless code comments.

medz avatar Oct 18 '25 13:10 medz

I'm already looking for alternatives or reverting to writing my own documentation. DeepWiki's original intentions and goals are great, but without a subscription, there are many uncontrollable issues, such as over-interpretation and over-promotion of the project.

For example, I have a state tool for Flutter, which is a technical experiment. Then DeepWiki boasts that it "completely changes the state of Flutter state management," which is very embarrassing and I have no way to correct it. ๐Ÿ˜‚

medz avatar Oct 18 '25 13:10 medz

I'm already looking for alternatives or reverting to writing my own documentation. DeepWiki's original intentions and goals are great, but without a subscription, there are many uncontrollable issues, such as over-interpretation and over-promotion of the project.

For example, I have a state tool for Flutter, which is a technical experiment. Then DeepWiki boasts that it "completely changes the state of Flutter state management," which is very embarrassing and I have no way to correct it. ๐Ÿ˜‚

I don't think the aim of adding this badge by any of the aforementioned repos above and the thousands of other repos, or by me, via this PR, was to depend on generated AI docs! Sure, you'll still have to write documentation where need be, especially for complex implementations. The aim here is not to replace Nitro or any other repo's documentation!

Keeping these AI models up to date with recent changes or updates is good for the ecosystem, especially when debugging or writing code where some internal APIs were recently deprecated, updated etc.

Their MCP server in VS Code is really helpful.

As for the frequency of re-indexed docs, one a week is better than nothing don't you think? At least when seach engines or other automated tools access these docs, don't you think getting something that is one week old is better than months old?

One of the main reasons I looked into adding this badge, apart from the fact that I saw these other repos do it was the fact that I was reading some docs about a feature and noticed the internals had been updated and it behaved a bit differently. Then I noticed the docs were last indexed in August.

franklin-tina avatar Oct 19 '25 04:10 franklin-tina

I'm using DeekWiki to write documentation instead of myself. But I've noticed that the documentation isn't updated regularly, forcing me to write a lot of meaningless code comments...

Bro, this is akin to vibe coding and depending fully on the generated code ๐Ÿ˜…

franklin-tina avatar Oct 19 '25 04:10 franklin-tina

By the way, thank you @medz I appreciate these conversations, especially last week when we were debugging the Cloudflare issue with Nitro v3. ๐Ÿ’š (of course, Pooya too)

franklin-tina avatar Oct 19 '25 04:10 franklin-tina

As for the frequency of re-indexed docs, one a week is better than nothing don't you think?

Absolutely agree. It is very useful to be able to track the latest changes at least once a week, especially when developers don't have much time to update the documentation website.

I appreciate these conversations, especially last week when we were debugging the Cloudflare issue with Nitro v3. ๐Ÿ’š

@franklin-tina This is what I'm supposed to do. I'm constantly monitoring the development of H3 and Nitro. (Ehmmmm~) Because I'm using Nitro v3 directly with Cloudflare in a large application.

This forces me to keep a close eye on things, as they haven't reached a production release yet. I have to ensure that every deployment of my application doesn't affect existing functionality, even digging deep to find workarounds.

medz avatar Oct 19 '25 04:10 medz