Nereuxofficial@programming.dev to Rust@programming.dev · 9 months agoExamples are not Documentationnereux.blogexternal-linkmessage-square15fedilinkarrow-up157arrow-down113
arrow-up144arrow-down1external-linkExamples are not Documentationnereux.blogNereuxofficial@programming.dev to Rust@programming.dev · 9 months agomessage-square15fedilink
minus-squaresugar_in_your_tealinkfedilinkarrow-up41arrow-down1·9 months agoThe only thing worse than a bad example is documentation like this: fn do_thing(…) Does thing. It adds nothing, other than letting you know they were there and decided not to actually provide something useful.
minus-squareNereuxofficial@programming.devOPlinkfedilinkarrow-up7·8 months agoYeah that just wastes both people’s time
The only thing worse than a bad example is documentation like this:
It adds nothing, other than letting you know they were there and decided not to actually provide something useful.
Yeah that just wastes both people’s time