Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

> Dummy modules to store your documentation (I've seen this used but can't remember one off the top of my head)

Yeah I've done this and it works fantastic: https://docs.rs/csv/latest/csv/tutorial/index.html

All the examples are tested too. So not sure about the problem there.

Can't speak to 'derive' docs. I rarely use derives outside of what std/serde give you, and I never publish any.

But even so, I didn't say that rustdoc has zero weaknesses. :-) I said it is one of my favorite things about Rust because it is just so damn good. I've tried writing docs in several other languages before and they are leagues behind IMO. I would absolutely not call it "crippled." Not even close.



Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: