External Publication
Visit Post

Source code on docs.rs: ambiguous and obscure

Rust Internals [Unofficial] July 8, 2026
Source

Speaking as someone who often needs to dig into the source code of crates he didn't write, in order to deal with gaps in the documentation: I'm surprised to hear that the source code view on docs.rs isn't the same thing as what I'd see if I pulled the git tree and opened it locally. That makes the source code view on docs.rs substantially less useful to me. I recognize the value of cross-referencing and whatnot but I think I would actually trade that for "the source code view matches what's in version control as of the indicated release"!

(It sounds like in practice they will only be different in unusual and/or malicious situations, but ... it's still a problem.)

Discussion in the ATmosphere

Loading comments...