Live data from Hacker News

How to begin a text

micaelwidell.com

41–50 of 54 posts

Re: How to begin a text

#41
post #9

In so many endeavors the hardest part is beginning. Starting a new job. Starting an exercise program. Quitting smoking. Leaving your comfort zone to do something new. For many people, starting a new software project can be intimidating: the open green field of endless possibilities can be paralyzing. Starting a machine learning class has made me feel dumb at first, so I quit. The trick is to just start, and understan…

As an extension of this I've also found asking questions helps with the growth mindset.

Often people are afraid to ask questions because they don't want to look stupid or admit ignorance, but explicitly admitting ignorance and asking what things mean or how things work in conversation actually has the opposite effect. You learn a lot faster and more often than not people feel more comfortable because you're being honest with what you don't understand.

The side effect is that you usually end up looking 'smarter' anyway - somewhat ironically not asking questions because of fear of looking stupid can lead to it becoming clear you don't actually understand something you're pretending to which then does make you look stupid.

I've seen two negative things that can come out of this - the first is the person that feigns surprise and says 'You don't know what X is?!". More common in college and around other people who are insecure about their own intelligence, best response to this is to admit ignorance again and re ask the question (usually becomes apparent that the person doing this doesn't know what they're talking about anyway and can't explain it well). I think this negative attitude is especially bad because it can disproportionately affect women in early CS because they are probably already worried about fitting in there anyway.

Second negative thing is that asking questions when you do know the answer to show how smart you are is not the same thing as admitting ignorance and asking questions to learn - it comes across as obvious and is annoying.

Long answer, but generally agree that growth mindset and treating negative experiences as 'learning experiences' is the way to go.

Re: How to begin a text

#42
post #32
post #6

The worst way to begin a text: In capter 1, we will describe ..., then in chapter 2 we will take a look at ..., and then in chapter 3, we ...

The worst way to end a chapter is "in this chapter we have seen...". Unfortunately that seems to common in programming texts, for whatever reason

It's because some teacher somewhere along the way came up with this writing advice, which we all received in high school:

"First, tell them what you're going to tell them. Then, tell them. Then, tell them what you told them."

Following that structure leads to terrible, boring writing. The only useful part is the second sentence.

Re: How to begin a text

#44
'Start in the middle' is only half the answer. An introduction has to teach the reader enough about the topic to care about the main idea (i.e. exposition in fiction). You can start in medias res (a la the iliad) but you may end up circling back in a flashback (a la the odyssey, odysseus telling his journey to menelaos' court).

Starting in the middle is great if your reader already knows the backstory, but you alienate everyone but your core audience. That's expensive whether you're writing a blog post or a hollywood blockbuster.

It's a fair assumption that your reader came to you on the promise of the title of your piece. You have to fulfill the promise of that topic or at least give a tidbit soon enough that your audience doesn't give up and leave. You can tell a book by its cover because books with misleading covers don't sell.

Balancing exposition against delivering on your genre promise is a 'theory of mind' skill that the best writers have in spades. Think of the first 10 minutes of star wars: scary villain darth vader (check) strolling through a sci-fi spaceship (check). Gun-toting strong princess (check) needing a rescue (check) sends her sci-fi robots (check) to get help. Next scene: crappy teenager main character (that's your audience, check) buys same robots.

The order of the villain / princess / hero scenes are optimized to serve the 'message for help / hero to the rescue' exchange. If this were a blog post you'd still have that 'problem / solution' structure but in both cases you need to be checking all your genre points and delivering breadcrumbs of the genre or topic that the reader is here to consume as you inform the reader enough to care about your argument.

Re: How to begin a text

#46
post #25

Earlier quoted context omitted.

(The Leidenfrost effect ( https://en.wikipedia.org/wiki/Leidenfrost_effect) )

Direct, working link, parent includes one of the parenthesis it seems: https://en.m.wikipedia.org/wiki/Leidenfrost_effect

Non-mobile link: https://en.wikipedia.org/wiki/Leidenfrost_effect

Re: How to begin a text

#48
post #4

It's like making pancakes. The first pancake is always going to suck. Just accept it and get through it so you can make a great batch of pancakes, or blog posts, or products, or...

I've heard lots of people say that, but it almost always just means the pan isn't hot enough! Wait an extra minute and the first one will usually be fine. I'm not sure how that translates back to writing, though...

All these years I thought I was spreading wisdom, but it turns out I just don't know how to make pancakes. :|

Re: How to begin a text

#49
post #4

It's like making pancakes. The first pancake is always going to suck. Just accept it and get through it so you can make a great batch of pancakes, or blog posts, or products, or...

I first heard this expression in Russian, "первый блин комом", is it actually used in English as well? Interestingly, Google actually translates this to "better luck next time" instead of "the first pancake will be a lump/clod"

Woah, that's a fun one to play around with. Pancake must be commonly used in idioms. Try deleting each word individually, it's pretty hard to get it down to pancake.

Re: How to begin a text

#50
From the article:

  > You delete until you reach the first sentence
  > that feels elegant and suitable to begin the text.
  > Usually you will find it about 2-3 sentences in.
Judging by most articles I read, I would say it's more like the first 2-3 paragraphs in.
Post reply on HN