article thumbnail

Writing & Grammar Workshop: Do Training Examples Need to Keep it Real?

The Logical Blog by IconLogic

" As soon as I saw this example, I knew that an IT person wrote the training example, not an accountant. The question of the day is this: to what extent do training examples need to be real-life examples? " In truth, the example would be a better sentence without those words. I hope you can join me.

Examples 164
article thumbnail

Writing & Grammar Workshop: Do I Have to Repeat "a" or "the" in a List?

The Logical Blog by IconLogic

In my most recent online writing class , I noticed that when deleting unnecessary words from a sample sentence, some students wanted to keep the word the before every item in a list, and some wanted to take it out. You cannot use the on the first, third, and last items, for example, while omitting it from the second item.

Voiceover 171
Insiders

Sign Up for our Newsletter

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

article thumbnail

Writing & Grammar: Should I Put a Comma after But?

The Logical Blog by IconLogic

by Jennie Ruby Here are some sample sentences to consider:   "[Switching from video games to electric cars] may not sound like the most obvious career shift, but , given Frohnmayer's location, it might be a smart one." Some examples of transition words are however , therefore , thus and hence.). " Inc.

Voiceover 186
article thumbnail

Technical Communications: Small Steps to a Giant Leap.

The Logical Blog by IconLogic

Battery technology is one example, and photo-voltaics is another. Consider that it only took 10 years for us to move from typewriters (1980) to laser printers (1990), from text-only Web browsers (1993) to websites with embedded movies (2003). In documentation, this might be called iterative development.

article thumbnail

Writing & Grammar Workshop: Would vs. Will

The Logical Blog by IconLogic

In training documents and manuals, we often have to tell the reader what will (or would) happen if they do (or did) a certain action. For example, suppose you want to tell the reader the consequences of pressing cancel.       If you press cancel, the document will not be saved.   

Voiceover 189
article thumbnail

Writing & Grammar Workshop: Acronyms Happen

The Logical Blog by IconLogic

 For example, below is a paragraph similar to the paragraph you are reading now, but using acronyms: The use of acronyms (UOA) can be a problem for readers of technical writing (RTW) and LENTs (learners encountering new terms for the first time). LENTs may have a hard time understanding the terms themselves and be very confused by UOA.

Scanning 138
article thumbnail

Writing & Grammar Workshop: Who versus Whom

The Logical Blog by IconLogic

  Here are some examples:   * Who/m put the sneakers in the dryer?*.   So far, we have seen only action verbs in the sample sentences. I'll share good examples next time. I also teach the Writing Training Documents and eLearning Scripts class.   The verb is put.

Voiceover 153