Examples are not Documentation (nereux.blog)

submitted 6 months ago by Nereuxofficial@programming.dev to c/rust@programming.dev

16 comments fedilink hide all child comments

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.

load more comments (4 replies)

this post was submitted on 03 May 2024

44 points (81.4% liked)

Rust

6055 readers

87 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

snowe@programming.dev

Ategon@programming.dev

EdTheLegendary@programming.dev

kahnclusions@programming.dev

torcherist@programming.dev