Hacker News Reader

Comment by szemet | Hacker News Reader

What a fine piece of literate programming!

I've just printed it out, and it literally contains 100 page of explanation and context for that 500 lines of code. Great work!

View on HN

Just curious, why print it out?

Printed out works are less distracting, you can also write on them with a pencil or highlight things you like. Also if the page ever disappears / becomes inaccessible you have a backup of it. Not something I do, but I can see the uses. A coworker did it to analyze someone else's code. Also it doesn't drain your eyes as much. I sometimes wish I could have a Kindle that just showed me code (with some syntax highlighting) so I could look at code on an e-reader type of display but never drain my eyes doing so.

> Also if the page ever disappears / becomes inaccessible you have a backup of it.

I get the other parts, but this is the one thing where having it in a computer format would be _more_ practical. :-) I would rather go the opposite way, i.e. scan physical book for the purpose of keeping a backup.

To soak up new code, infrastructure diagrams, etc I’ll print it all all, 3 hole punch it, and put it in a binder to leaf through with a pen or highlighter on the couch.

So much more information is retained I find doing it this way over using Visio or Sublime.

Some people like to read the dead-tree version. Nostalgia, maybe paper is better for the eyes, paper books are generally lighter than the equivalent sized tablets or ebooks, etc.

It feels good to step through some code just using paper and pencil with all computers off. It's not for everyone, I get that, but some of us love it. I tend to walk away with a much deeper understanding of the code. I don't do it all the time nor do I need to. I reserve this ritual for truly interesting pieces of code.

Not tech books, they usually weigh a tonne.

True, because most of them either add a million diagrams or a million copy-pasted source code snippets. And this happens because people "respect" a thick book when they are looking for a technical book. It's quite silly, actually :)

Somewhat tangentially related, I would like to know how the parent poster or for that matter printed the document.

somewhat unrelated, I don't use emacs but is there a way to break lines such as

#+caption: [[https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux....]

in the org mode source? https://blog.lizzie.io/linux-containers-in-500-loc.org

You can export from org to pdf (type C-c C-e l p in emacs). For some fine tuning you can export to tex and then use pdflatex.

It's kind of strange, considering that most of the non-fiction books I remember most fondly, are fairly thin. The big tomes tend to largely be forgettable (there are of course exceptions) - I guess often because they go into too much detail that date rather than concisely describing concepts.

Because many of us needed to thrust our work to thick books on the days before ubiquitous Internet. :)

Because viewing things on a LCD is hard on the eyes after a while. E-ink is great, but paper is easier for most.

This is one thing I hate about Apple these days. They once had pdf versions of all the developer documents but now they only have web pages and Xcode. For a company so concerned about users, they sure don’t seem to care about developer’s eye strain.

Not having an easily printable document also means you cant leave one or multiple copies of an important document around the workspace for convenient reference and as a physical reminder or even a prompt for discussion.

The Apple HIG (Human Interface Guidelines) used to be a great document to have printed out and left lying around for reference, and as a starting point for discussion.

The battery never dies on a paper copy.

Also, there's no Amazon take backs.

An HTML file on your local disk does not have Amazon take backs either.

A paper copy never survives an accidental home fire.

That said, the owner might not survive as well.

Anyways, I find reading on paper so much better than reading E-Ink as well, got a Kindle paperwhite, and it's out of battery somewhere because highlighting and note-taking (I do it a lot while studying) feels so much better with physical copies. Only reason for me to take the Kindle for a walk is when I'm traveling and weight is a concern.

I ask the same question from my wife! Some people only read on paper. We have two of each book because I read on Kindle and she reads it on the actual physical book.

Other than "active" pages with live charts and other data (which are great!), as well as Control-F (which cannot be understated), I prefer paper books on every possible way.

They're easier on my eyes. They're easy to bookmark forever. You can sort your books in a way that the physical placement of your book itself (the thickness, the colors, whatever) helps you organize or remember important details instead of just getting lost in a pile of ebooks in folders. And the backlights are bad for trying to fall asleep while reading which may sound odd, but I have the _least_ ADD when I'm about to fall asleep and everything calms down so I learn the best.

I use ebooks, but I absolutely prefer the real thing whenever possible.

And I say all of this as someone who has given away all of his DVDs and won't buy BluRays for his movie collection. I'd rather just rip something and dump it to my hard drive. Those little DVD boxes were filling many shelves and I was like "Why? All I do is watch them. And the bloody intro ads treat me like I'm a pirate for buying them."

So my point there is, I'm not just some sentimental person who clings to physical things. I like my physical books because they're better for me.

But, I'm not some zealot who thinks, "Anyone who uses ebooks is wrong/worse/whatever."

"They're easy to bookmark forever"

Have you ever dropped a book and lost your page? What a tragedy :)

I get distracted a lot when I read online. The browser is one click a way. With a book you can sit away from your computer, underline. Diagrams look better. You can focus more.

Reply on news.ycombinator.com