Generate and insert Rustdocs into your Rust projects without a huge model or agent spaghetti 🦀 (github.com)
from exgf@programming.dev to rust@programming.dev on 03 Oct 02:39
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.

#rust

threaded - newest

SanctimoniousApe@lemmings.world on 03 Oct 06:11 next collapse

Who’s "Agent Spaghetti,’ and what do they want?

exgf@programming.dev on 03 Oct 06:25 collapse

😂😂😭

balsoft@lemmy.ml on 03 Oct 09:14 collapse

IMHO generated docs (and yes, LLM spitting out stuff is generated docs) should not be committed to the repo. Something like this should happen on the cargo doc/docs.rs side (with opt-in from the user, of course). This has a couple major benefits, the main one being that the docs can improve as the LLM improves.

exgf@programming.dev on 03 Oct 18:29 collapse

I am in total agreement EXCEPT where I differ is that I believe no autogenerated docs should be committed to the repo without being proofread and improved. I see it like scaffolding.