Nereuxofficial@programming.dev to Rust@programming.dev · 5 months agoExamples are not Documentationnereux.blogexternal-linkmessage-square15fedilinkarrow-up156arrow-down113
arrow-up143arrow-down1external-linkExamples are not Documentationnereux.blogNereuxofficial@programming.dev to Rust@programming.dev · 5 months agomessage-square15fedilink
minus-squaresugar_in_your_tealinkfedilinkarrow-up41arrow-down1·5 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·5 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