44
you are viewing a single comment's thread
view the rest of the comments
[-] anlumo@feddit.de 12 points 6 months ago

clap and bevy are big offenders there. It's really hard to learn how to use them due to this.

[-] tatterdemalion@programming.dev 5 points 6 months ago

Are you kidding me? Clap has some of the best documentation of any crate.

[-] anlumo@feddit.de 1 points 6 months ago

I just checked again, and apparently they finally added some documentation since I last checked. The section about the macro stuff just used to say “look at the examples”.

[-] tatterdemalion@programming.dev 1 points 6 months ago

Ah that explains it.

[-] SatouKazuma@lemmy.world 2 points 6 months ago

It sucks that there aren't (in my limited experience) a ton of engines out there with good documentation (at least that are built in Rust). I've started trying to build my own engine, but the complexity and time required are certainly a bit of a barrier, especially for the game I'm working on. (N.B. - The game is nowhere close to being in any sort of state to be shown, so please don't ask 😆)

[-] anlumo@feddit.de 2 points 6 months ago

My experience has been that good documentation is mostly something done if somebody gets paid for the work. People working on stuff in their spare time just don't care enough to document their project.

[-] SatouKazuma@lemmy.world 1 points 6 months ago

That, or they don't care enough to pick it back up if they ever drop it. Nothing hurts worse than forgetting what you're trying to do because you don't even comment your code.

this post was submitted on 03 May 2024
44 points (81.4% liked)

Rust

6055 readers
162 users here now

Welcome to the Rust community! This is a place to discuss about the Rust programming language.

Wormhole

!performance@programming.dev

Credits

  • The icon is a modified version of the official rust logo (changing the colors to a gradient and black background)

founded 1 year ago
MODERATORS