Friday, September 9, 2022

Understanding Chunking, Ordering, and Parallelism

I love tea. Let's make two cups and share them together. Now, the trouble is I like to drink it but don't know how to make it. Let me ask my mother, whom I usually trouble to make me tens of cups daily. And write down its recipe.

Ingredients

  • One cup of milk
  • Ginger (1 inch) - Optional
  • Water (1.5 cups)
  • Sugar (1tsp)
  • 1 tsp of tea leaves
  • Cardamom (Two) -Optional
Recipe

  1. Boil water.
  2. Water should be steaming hot when you put the tea leaves. Wait for two minutes.
  3. Nice smell starts to reach your nose. It is time to put in a little sugar.
  4. Add milk.
  5. Want your tea strong? Beat up ginger and cardamon, as if they are your enemies.
  6. Let it simmer. After the color is dark, alternately turn the flame up and down for two-three boils.
  7. Strain it using a sieve. 
  8. Let's sit together with our cups and start our conversations.
You may find your tasty but there is something very distasteful about this writing if the buddy you are having your tea with happens to be a technical writer.

Let's give our recipe to him for review. 

Ingredients

  • Water (1.5 cups)
  • Milk (1cup)
  • Tea leaves (1tsp)
  • Sugar (1tsp)

  • Ginger (1 inch) - Optional
  • Cardamon (Two) - Optional

Recipe

  1. Boil water.
  2. Put the tea leaves when the water starts to steam. Wait for two minutes.
  3. Put sugar.
  4. Add milk.
  5. Beat the ginger and cardamom and put it in boiling tea.
  6. Let it simmer. After the color is dark, alternately turn the flame up and down for two-three boils.
  7. Strain the tea using a sieve. 
Please note the order in the unnumbered list. The order is said to be immaterial for an unnumbered list, but why change it here?

Also, note the line spacing between two sets of ingredients? Why the separation here?

The quantities of the ingredients are mentioned in a specific manner too.

And the Recipe, what structure do you see? Does it seem someone is instructing you in a direct manner? How is it so?

Think about it. The terms will become clearer.

Don't forget the leading line when you write your lists and procedures. I was lazy, I didn't have my tea. Got cold while I was writing the post.


No comments:

Post a Comment