6

cross-posted from: https://programming.dev/post/38477847

Awful Rustdocs is a CLI tool that generates or improves Rustdoc comments by harvesting symbols via rust_ast.nu, enriching each item with ast-grep context (callers, intra-body calls, qualified paths), and prompting your LLM to produce concise, high-quality docs.

You don't need hundreds of prompts and agents if you're smart about your context.

I'm running it on all my Rust projects right now using the Systems Programming Qwen 3 4B finetune I created, and it saves me an incredible amount of time by creating docs that are almost always good enough to publish straight off but act more as a draft for me. It cuts down on a lot of repetitive typing and lets me get back to doing what I love (writing code).

It requires Nushell, but you should probably already be using that, and if this is how you find out about Nushell, then even better, make the jump; it's worth it.

you are viewing a single comment's thread
view the rest of the comments
[-] locuester@lemmy.zip 4 points 1 week ago

Nice project. Seems a bit heavy on the dependency side.

Psst: step 2 of the install instructions has a question to you from the LLM writing the docs. lol

[-] exgf@programming.dev 1 points 1 week ago

Oof, thank you for the catch.

[-] exgf@programming.dev 0 points 1 week ago

Every project is way too heavy on the dependency side imo, removing as many deps as I can from my projects is on the TODO list.

this post was submitted on 03 Oct 2025
6 points (58.8% liked)

Programming

23074 readers
106 users here now

Welcome to the main community in programming.dev! Feel free to post anything relating to programming here!

Cross posting is strongly encouraged in the instance. If you feel your post or another person's post makes sense in another community cross post into it.

Hope you enjoy the instance!

Rules

Rules

  • Follow the programming.dev instance rules
  • Keep content related to programming in some way
  • If you're posting long videos try to add in some form of tldr for those who don't want to watch videos

Wormhole

Follow the wormhole through a path of communities !webdev@programming.dev



founded 2 years ago
MODERATORS