6 ms·
This is awesome! I will prefer all my technical documentation in children's book format from now on.
by faster_harder 5y ago
This is awesome! I will prefer all my technical documentation in children's book format from now on.
- monksy 5y agoWhy?
- michaelcampbell 5y agoDifferent strokes, I guess; I can't count the number of people that openly gush about _why's Ruby book with the cats or whatever, but to me it just read like the ravings of a highly functional something-opath. But reasonable people can disagree, and I'm sure I'll get downvoted for disagreeing with the hivemind.
- throw1234651234 5y agoMy initial impression was "more of this garbage" - but it was really well done in the sense that it distilled the core functionality of the system in an easy-to-understand form. The guy above you mentioned manga-guides to stuff, which utterly fail at their job, which again, is to distill key-information in an entertaining, easy-to-read, general (but fully accurate) manner.
- bee_rider 5y agoI don't really get these weird ways of explaining different technologies, just give me a straightforward text description. But straightforward text isn't going anywhere and it doesn't hurt me if people want to read mangas about foxes or whatever.
- monksy 5y agoYea that's where I was going with asking why. It feels like it's a trendy thing is to convert a technical thing into a children's book. (Which is odd.. children don't need that book.. so it's for an adult that wants to consume children's literature) Note: I'm not against creative attempts to explain technical concepts. But the form to me seems odd, and that it feels like we're producing very short tutorials in a childrens format. That's even weirder.
- haswell 5y agoTo me, the attraction is less about the specific art used to communicate the concept, and more about the careful attention to a fully-formed analogy that explains the tech in completely different terms. These kinds of explanations tend to focus on the most critical/important concepts, and help validate (or dispel) assumptions I've made about the tech. This focus on analogy also lets the author tell the story faster, because I already understand: - What an otter is - That rivers flow - The water flowing down a river that forks will be spread across those forks - etc... Depending on the strength of the analogy, it's possible to get the reader on the same page much faster than an intro/tutorial that must first explain foundational concepts just to get to the basics of the technology itself.
- caymanjim 5y agoDo people find these analogies helpful? The concepts aren't that difficult, the audience for them is already technical, and adding a cutesy abstraction about it makes it harder to understand. The art and animation in this is great, but I feel like the author's talents are wasted on a document with no audience. Make a kids' book instead!
- bee_rider 5y agoI've never really been a fan of analogies, because I feel like in the end I just need to first understand what the thing is underneath, so I can understand how the author has built their analogy... so the task of understanding why they used this analogy is equivalent to understanding the thing itself. But I can't deny they are very popular!
- filterfish 5y ago> ravings of a highly functional something-opath I'm going to try and fit this into as many sentences as I can get away with!
- ericwood 5y agoI never found it helpful from a purely technical perspective, but I found it extremely eye-opening as an unorthodox approach to programming that really captured my imagination. It was definitely something that encouraged me to dig deeper into Ruby and do more explorative "creative" coding. There's no shortage of dry technical documentation, so seeing something akin to outsider art in that space was really refreshing. Personally I would love to see more technical books come with a soundtrack!
- jabroni_salad 5y agoI like the novelty of it. I have a copy of The Manga Guide to Databases at my desk that I occasionally 'lend out' to people that mess up my databases. It won't turn anyone into a db hero but it's a decent primer at least.
- sdoering 5y agoWhat the heck. I didn't know this was a thing. Thanks for the pointing it out.
- caffeine 5y ago_why, that’s why.
- firebones 5y agocaffeine gets it...
- teekert 5y agoBecause to me it seems like a very pure way of separating a concept from implementation. In language and metaphors that are easy to understand and fun to read. I really like it. Now, in a very short time I can decide if Kafka can solve my problem or whether I should move on. I for one store information presented in this way much better, it's feasible that in 5 years I'm presented with a problem and the Otters pop into my mind. Different people, different preferences I guess.
- searchableguy 5y agoAgreed. Author has done magnificent work on the illustrations and animations. This prompted me to make an awesome repo to collect children's books on technical topics (which I have seen a few on HN). https://github.com/searchableguy/awesome-illustrated-guides https://github.com/searchableguy/awesome-illustrated-guides I couldn't find a similar list. If there's one, let me know.
- vincentmarle 5y agoGoogle Chrome - https://www.google.com/googlebooks/chrome/ https://www.google.com/googlebooks/chrome/ Google Machine Learning - https://cloud.google.com/products/ai/ml-comic-1 https://cloud.google.com/products/ai/ml-comic-1 Google Federated Learning - https://federated.withgoogle.com/ https://federated.withgoogle.com/
- rossdavidh 5y agoWell, you should really include the story of Ping: https://www.amazon.com/review/R2VDKZ4X1F992Q https://www.amazon.com/review/R2VDKZ4X1F992Q :)
- wbl 5y agoSELinux coloring book!
- redsummer 5y agoSome of these may be of use: https://nostarch.com/manga-guide-13-book-set https://nostarch.com/manga-guide-13-book-set Also, why’s guide to ruby, though it’s probably out-of-date: https://en.m.wikipedia.org/wiki/Why%27s_(poignant)_Guide_to_Ruby https://en.m.wikipedia.org/wiki/Why%27s_(poignant)_Guide_to_...