top | item 45517589

(no title)

md224 | 4 months ago

I suspect this was written with an LLM and the author didn't actually verify that the examples in the README worked.

discuss

order

dymk|4 months ago

Recently, I ripped usage examples out of a rust project's README.md, and put them in doc comments. Almost all of them were broken due to small changes over time, and I never remembered to update the readme. `cargo test` runs doc comments like mini integration tests, so now the examples never rot. I wish more languages and tools had this feature.

It means having to go to the linked docs (which are automatically pushed to the repo's github pages) to see examples, but I think this is a reasonable tradeoff.

urvader|4 months ago

I wrote this with an LLM but manually changed the README. Thanks for pointing this out, it is now updated.