Hacker News new | ask | show | jobs
by mikekchar 2313 days ago
I like working offline and do it frequently. In fact, if I would just turn off my tethered 4G right now, I would get a lot more done and be much happier with myself. Will be doing just after I finish typing this :-). Because I use my computer primarily for programming, the biggest thing I need are docs. In that respect, I've found that working with Rust is amazing. Installing all the normal documentation you need and then going offline is so incredibly easy. Anyway, massive shout out to anyone that pushed to make that dream a reality!
1 comments

I use a tool called Zeal on linux which makes using docs even better than in a browser since its pretty much instant.
I have used this in the past with Ruby. I liked it well enough, but I was frustrated trying to get the right versions of things (I world on some older code bases -- including Ruby 1.8 :-P ). Getting all the ri docs for things that are 10 or more years old is incredibly painful. I could potentially build them myself, but that is also surprisingly painful.

The thing I like about Rust's setup is that things just work out of the box. `rustup doc` opens a page containing the Rust book, Rust by example book, all of the API documentation and more -- all for the version of Rust that I currently have installed. `cargo doc` builds all of the documentation for all of the crates that I am using in my current project. All of the documentation is for the versions of the crates I'm using. It's just very seemless.

The really cool part of the Rust docs is that all of the API documentation (and crate documentation) has links to the source code. So if I can't understand what the documentation is saying, I can read the code. It's incredibly helpful. I must use that feature 5 or 6 times a day.

But, yeah, Zeal is quite useful and I really should set it up again for my Ruby stuff.