Skip to content

Instantly share code, notes, and snippets.

@rstacruz
Last active August 31, 2021 14:50
Show Gist options
  • Star 17 You must be signed in to star a gist
  • Fork 1 You must be signed in to fork a gist
  • Save rstacruz/25525526669df913571000933d938a60 to your computer and use it in GitHub Desktop.
Save rstacruz/25525526669df913571000933d938a60 to your computer and use it in GitHub Desktop.

Language tips

Try to be mindful of your words in written communications. Here are some tricks to leaving a good impression with written words online.

Avoid "do" and "don't"

When writing imperative sentences, try not to start your sentences with "don't." Try the word "avoid" instead.

  • ⚠️ "Don't use big words."
    This imperative command can make the reader feel like they have no choice on the matter. It implies that the decision lies solely on you, which implies that you don't want to listen to their feedback.
  • "Avoid using big words."
    Wording it this way lets you offer a suggestion, empowering the reader to be part of the decision.

Conversely, try to use the word "consider" when writing your suggestions. It has the same effect of communicating a suggestion in a way that invites participation from your reader.

  • ⚠️ "Use a rounder button radius here."
    Just like with "don't," an imperative command like this may alienate your readers.
  • "Consider using a rounder button radius here."
    The word "consider" offers a suggestion, just like "avoid." You may also use the word "try."

About "I feel"

When writing about your opinions, be mindful about using the word "I feel." It shows that you're unsure about your opinions, so only use it when that is indeed the case. Instead, the phrases "I think" and "I believe" can show more conviction. These two examples make sense:

  • "I feel it looks better in blue instead. What do you think?"
  • "I think it looks better in blue instead. It draws attention better than gray."

While these two seem awkward:

  • ⚠️ "I feel it looks better in blue instead. It draws attention better than gray."
  • ⚠️ "I believe it looks better in blue instead. What do you think?"

Careful with "please"

When writing text, think twice about using the word "please." Without any vocal stress, it can either sound polite or condescending. Your reader may hear your words differently, depending on where they mentally place the emphasis:

  • ⚠️ "Can you please check this out?"
  • ⚠️ "Can you please check this out?"

You can omit the "please" and still sound polite in many cases.

  • "Can you check this out?"

Avoid words with 3 or more syllables

Using long words doesn't make you look smart, it makes your reader less likely to read your words. These next two sentences say the same thing, but the second one has less syllables-per-word, making it more inviting to read.

  • ⚠️ "Utilizing lengthy verbiage can make sentences difficult to understand."
  • "Using long words can make text hard to read."

The Hemingway Editor can help find these words for you.

Avoid using red lines

When marking up images, avoid using red lines, even if they describe errors. Instead, consider a more neutral color like blue or orange. Red marks can trigger a visceral reaction to the viewer, which can make them reluctant towards your suggestions.

This image below can feel like someone is pointing out a mistake.

image

By avoiding red, the annotations feel more like they're simply trying to attact focus.

image

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment