News for hackers. Stuff that matters.
Re:I wrote a children's book / illustrated guide to Apache K... by faster_harder on Thursday June 17, 2021 @01:19PM (#27542016)
This is awesome! I will prefer all my technical documentation in children's book format from now on.
Re:I wrote a children's book / illustrated guide to Apache K... by _3jh0 on Thursday June 17, 2021 @03:29PM (#27543570)
Agreed. 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

I couldn't find a similar list. If there's one, let me know.

Re:I wrote a children's book / illustrated guide to Apache K... by vincentmarle on Thursday June 17, 2021 @07:12PM (#27545511)
Re:I wrote a children's book / illustrated guide to Apache K... by rossdavidh on Thursday June 17, 2021 @07:41PM (#27545709)
Well, you should really include the story of Ping: https://www.amazon.com/review/R2VDKZ4X1F992Q :)
Re:I wrote a children's book / illustrated guide to Apache K... by wbl on Thursday June 17, 2021 @09:19PM (#27546386)
SELinux coloring book!
Re:I wrote a children's book / illustrated guide to Apache K... by monksy on Thursday June 17, 2021 @02:14PM (#27542631)
Why?
Re:I wrote a children's book / illustrated guide to Apache K... by jabroni_salad on Thursday June 17, 2021 @03:54PM (#27543863)
I 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.
Re:I wrote a children's book / illustrated guide to Apache K... by sdoering on Thursday June 17, 2021 @04:28PM (#27544195)
What the heck. I didn't know this was a thing. Thanks for the pointing it out.
Re:I wrote a children's book / illustrated guide to Apache K... by michaelcampbell on Thursday June 17, 2021 @02:37PM (#27542911)
Different 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.
Re:I wrote a children's book / illustrated guide to Apache K... by bee_rider on Thursday June 17, 2021 @04:43PM (#27544349)
I 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.
Re:I wrote a children's book / illustrated guide to Apache K... by haswell on Thursday June 17, 2021 @07:00PM (#27545408)
To 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.

Re:I wrote a children's book / illustrated guide to Apache K... by bee_rider on Friday June 18, 2021 @03:44PM (#27554130)
I'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!

Re:I wrote a children's book / illustrated guide to Apache K... by caymanjim on Thursday June 17, 2021 @07:24PM (#27545588)
Do 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!

Re:I wrote a children's book / illustrated guide to Apache K... by monksy on Thursday June 17, 2021 @06:52PM (#27545346)
Yea 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.

Re:I wrote a children's book / illustrated guide to Apache K... by throw1234651234 on Thursday June 17, 2021 @04:28PM (#27544210)
My 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.

Re:I wrote a children's book / illustrated guide to Apache K... by ericwood on Friday June 18, 2021 @10:55AM (#27551004)
I 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!

Re:I wrote a children's book / illustrated guide to Apache K... by filterfish on Friday June 18, 2021 @12:07AM (#27547253)
> 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!

Re:I wrote a children's book / illustrated guide to Apache K... by teekert on Friday June 18, 2021 @03:10AM (#27548072)
Because 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.

Re:I wrote a children's book / illustrated guide to Apache K... by caffeine on Thursday June 17, 2021 @05:08PM (#27544531)
_why, that’s why.
Re:I wrote a children's book / illustrated guide to Apache K... by firebones on Thursday June 17, 2021 @11:41PM (#27547140)
caffeine gets it...