4 ms·
A bit confusing at first, but quite the novelty to use something like rustdoc and docs.rs as a blogging platform.
by hansjorg 7y ago
A bit confusing at first, but quite the novelty to use something like rustdoc and docs.rs as a blogging platform.
- roblabla 7y agoIt's become a bit of a tradition, with the new rustacean[0] being the first to do it I believe, as far back as 2015. rustdocs being just markdown with the convenient aspect of testing that your rustdoc actually works makes it a really good target for this kind of blogging! [0] https://newrustacean.com/show_notes/ https://newrustacean.com/show_notes/
- Narishma 7y agoI was confused as well. I thought it was the official Rust documentation until I read your comment.
- saghm 7y agoSlightly OT, but in case anyone else is curious, official Rust documentation lives at doc.rust-lang.org. docs.rs is auto-generated docs for packages published on crates.io.
- steveklabnik 7y agodocs.rs is run by the Rust team these days, so it is also "official", but documents un-official things.
- saghm 7y agoFair enough! "documents un-official things" is what I intended to imply; apologies if I wasn't clear
- steveklabnik 7y agoIt's chill! It used to be its own thing, and I'm not sure if people know that it's not or not anymore :)
- saghm 7y agoNow that I think of it, I'm not actually sure whether I knew before that it was official or not. I've definitely been using it for a long time now though, so I'm happy to hear it's in good hands!
- quazar 7y agoPeople in the Racket community also sometimes to use Scribble[1] to write their blogs. https://docs.racket-lang.org/scribble/ https://docs.racket-lang.org/scribble/