upvote
I agree that education is not storytelling, but I think that storytelling can be a useful tool for education.

A lot of Paul Graham and Joel Spolsky posts don't get straight to the point and usually do not follow an intro -> body -> conclusion format. A lot of them start with a story that makes the direction of the post unclear[0] or include long digressions whose value isn't immediately obvious.[1]

For a while, I struggled with this contradiction because I think good writing should quickly demonstrate the value a reader can expect, but I think Graham and Spolsky are excellent writers that frequently take their time in getting to their point.

The easy answer is that Graham and Spolsky are famous, so they can do whatever they want, and people will still read. I've come to think it's actually that writers like Graham and Spolsky are so good that the quality of the writing itself is the thing of value that keeps you interested even if you don't know what point they're going to make.

[0] https://www.joelonsoftware.com/2000/04/06/things-you-should-...

[1] https://paulgraham.com/worked.html

reply
Over the years, readers learned what to expect from Joel and Paul, which gave them freedom to continue writing in their own style. I'm curious how the same writing would be received today in a very different environment - much more crowded and driven more by social media than the open web, not to mention the shift of attention towards video. I just don't think writers today have access to the attention that tech bloggers of an earlier era built up.
reply
There is a balance. A short story can help understand. However you can go too far with stories. Joel strikes a good balance because it isn't long before you realize why the story is relevant and he cuts out a lot of details that are not relevant. He also is telling non-fiction stories, which adds additional credibility (unlike many blogs that are making up fiction stories)
reply
I think you are getting confused with the format for the reader. Someone looking for a light read would prefer a entertaining read with the twist of learning something, someone looking to learn something will be annoyed at your prose and narration style. What you write is aimed, whenever you like it or not, to a person in a particular state of mind. The motivated to learn will want you to not tell them about your grandma when they are reading the stupid recipe.
reply
I think that's a factor as well. If the reader has a specific goal in mind, and your blog post presents itself as a way for the reader to satisfy their goal, then the reader will probably have less patience for stories.

But to take Spolsky's "Things You Should Never Do" as an example, obviously nobody's Googling, "things to never do," clicking Joel's article, and then getting annoyed at Joel for not telling them immediately. They're finding the post on HN, RSS readers, forums, etc., where they didn't have a specific goal in mind beyond learning/entertainment, so the author has more room to take their time.

reply
With all due respect, PG and JS were titans of an era where attention spans were not short. I am not sure if that strategy would work in the LLM-era.
reply
My undergraduate research advisor told me "Papers and presentations are not murder mysteries." I try to keep that in mind whenever I approach explanatory writing, because the purpose is to help the audience reach understanding of where you ended up, not to replicate the epiphany you had yourself.
reply
Heh. Mine, before the diploma defense, literally told me "Assume that the panel knows everything about the math except for the stuff your did in your thesis, so tell them about that. Don't bother explaining what 'error correction codes' are, tell them about your specific construction and practical boundaries you've determined". Which, I guess, is precisely "the reader knows everything I know except this one thing" antipattern but then again, blogging is different from e.g. conference presentation, isn't it?
reply
Yeah, deciding on your assumptions about the audience's prior knowledge is one of the toughest parts of presenting information well, I think. If you give too much info, you come across as boring or patronizing; if you don't give enough info, most (if not all) of your audience will rapidly lose interest. But it's all gotta be based on your exact audience in the moment, and that's really hard to take into account a lot of the time.
reply
> Yeah, deciding on your assumptions about the audience's prior knowledge is one of the toughest parts of presenting information well, I think.

Right, all good (human) communication boils down to both the author and the reader having a theory-of-mind for one-another. The writer must anticipate what a reader will be thinking, and a reader must imagine [0] what the writer wanted to convey.

That's part of what makes the modern epidemic of LLM slop so frustrating: The correctly-formed words make us waste effort trying to reconstruct a mind that was never really there. Like some animals encountering an extremely realistic plastic fake that we cannot eat/mate-with.

reply
Ooh yes, I like that way of framing the problem. I'll have to remember that!
reply
deleted
reply
I was handed the paper: A rational design process, how and why to fake it [0]. It's still one of my favorit papers. Basically it tells you to, when writing documentation, go back and put in later findings in the place it would been, if the world had been completely rational. Just leave out all the weaving and late discovery, very few people cares. Retrofit documentation to pretend that everything and everyone was completely rational and had all the knowledge at the correct times. It can cut down documents by a lot.

0) https://users.ece.utexas.edu/~perry/education/SE-Intro/fakei...

reply
There's phone books worth of pages and text that never end up getting to the point.

I don't know if it's still there, but Grammarly used to have an AI feature that specifically made text longer. It was literally a button that says "Make longer."

reply
If I am reading a cookbook, tutorial, or reference to teach myself quickly so that I can accomplish something specific, I completely agree with you. Blog posts can teach something, of course, but when I choose to read a blog, I am hoping to experience a bit of the writer's personality and to be entertained in the process. Storytelling accomplishes both nicely. Also, when I read a blog post, I am not in a rush and don't want to feel like I should be.
reply
I think the appropriate level of "storytelling" depends on the type of blog post. A "bug hunt" type of post is often told as a detective story. A benchmark post has almost zero storytelling. Different purposes warrant different approaches.
reply

  > education is not storytelling 
I actually disagree. We're humans and we love stories. They keep is engaged and are a good way to compact information. But it also is highly dependent on how it is done. Truth be told, we're constantly telling stories and I think part of the problem is not being cognizant of this.

  > People want to save "twists" and "revelations" for maximum impact and it's harmful.
Maybe I'm misreading you. "Plot twists" would certainly be the wrong implementation. But when teaching one of my goals is to get students to be trying to ask a question that I'm about to answer. That's the story part. I'm leading them down the path and they should have suspicions about what lies around the next corner.

So basically a goal is that I'll stop for questions at some point and if I'm successful there'll be a student that asks a question we've been building up to and that I'm about to ask and/or answer. But there shouldn't be a "plot twist". I'm not trying to surprise students (usually :), but rather the story should make sense. As an educator[0] my goal is to get students to remember certain things and ask the right questions (a skill that's non-obvious yet people are overly confident about their level).

A good example of story driven writing is Cropper's The Quantum Physicists: And an Introduction to Their Physics. I really enjoyed this in my undergrad because it not only taught the physics but taught it in a historical manner. I said there's compression in story telling and this style of teaching did a great job at motivation of why these physicists were asking these questions. It gave context. I honestly think it had a big impact on me and helped push me into research (I do ML, not physics).

Certainly there's a time and place for being terse and hyper fixated on the information you're trying to teach but often we're trying to do a lot more than that.

FWIW, I think LLMs are terrible at this. They make everything seem "exciting". When everything is "load bearing" then nothing is. They're really bad at the context and understanding the bigger picture. They're especially terrible at responding to a question with something like "keep that question in mind, we'll come back to it in next week's lecture"

[0] I'm currently in industry

[1] https://archive.org/details/bwb_S0-BVP-068

reply
In journalism this is called “burying the lead.”
reply
In journalism it’s more commonly called “burying the lede”.
reply
[dead]
reply