Documenting my code - I am astounded

How To
1

I have to say, I’m having an emotional moment. This is the future I envisioned when I was ten years old in 1977.

I have a very large API that I’ve been working on. Cursor has been very helpful in working with me on my architecture and, when I let it, my code. I’ve been a developer for decades, so I’m not “vibe coding” as much as using it as a tool to do the stuff I’d assign a junior developer to help with. In that, it excels.

But tonight, I took a leap.

I told it to generate a complete documentation tree. I spent a few hours working up my best prompt set along with .mdc rules files. I installed Mermaid and PlantUML for diagrams. I then set it lose.

Oh. My. God.

This documentation is 95% perfect. It covers everything. It’s complete and accurate. It has a very rational tree and layout. It links intuitively. It follows rules I gave it like expanding acronyms the first time they’re used in any section. When it calls out another document, especially when explaining architecture (like noting that particular structure is comprised of fields as codified by a particular RFC), it links to that document (the RFC).

If I’d done this myself, with infinite free time?

MONTHS. At best.

Cursor, orchestrating a model, took about 20 minutes. And some of that was the time it took the tools to generate PNG files, or a script (that the model wrote!) to generate proper headers.

I am not being hyperbolic when I say that the singularity is here.

I need a drink :slight_smile:

11 Likes
2

Really great, what model did you use for it?

3

did you set cursor to AUTO or use a specific LLM? I am with you, an anient millenial, and this has been life changing. I’m shocked at how many people don’t know about this yet. I’ve tried bolt, databutton, replit, loveable, windsurf, and I come back to CURSOR every single time. Just avoid nextjs with supabase, as the LLM cannot work through the problems those two have with each other.

4

Also, anything you want/can share, would love to learn and help each other. I am building this 100% with cursor and supabase.
diji.art/designs to house our 50,000 curated designs and apparel. So far its like legoes for a kid on the first day each time.

5

I had a similar moment after spending almost a month trying to fix a recurring bug in my web app. Would you be willing to share any insight regarding your process? I would like to create documentation for my organization’s codebase. It’s large, outdated, and very poorly organized.

In addition to the model you used, I would love to know what prompts, rules, and any other context that you found most helpful. Achieving such impressive results in just one request is quite astounding, well done!
Hopefully you enjoyed that drink, @dogberry!

6

Absolutely. I’ll gather my .mdc files for this and post them later today. No company secrets in there :slight_smile:

4 Likes