Writing good docs, blogs and technical articles

Updated at
Reading time
2min

Articles

Writing should be like music. 👇

This sentence has five words. Here are five more words. Five-word sentences are fine. But several together become monotonous. Listen to what is happening. The writing is getting boring. The sound of it drones. It's like a stuck record. The ear demands some variety. Now listen. I vary the sentence length, and I create music. Music. The writing sings. It has a pleasant rhythm, a lilt, a harmony. I use short sentences. And I use sentences of medium length. And sometimes when I am certain the reader is rested, I will engage him with a sentence of considerable length, a sentence that burns with energy and builds with all the impetus of a crescendo, the roll of the drums, the crash of the cymbals-sounds that say listen to this, it is important. So write with a combination of short, medium, and long sentences. Create a sound that pleases the reader's ear. Don't just write words. Write music. — Gary Provost

Apparently, there's the royal order of adjectives which defines when they must be divided by a comma. General rule: if the adjectives can be joined by "and" or the order can be changed and the sentence still makes sense, use a comma.

The actress wore a [beaded], [feathered] costume.

The actress wore an [antique red beaded], [feathered costume].