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

by Jennie Ruby

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. Here is the original wordy sentence:
 

You must order the lumber, as well as the nails, additionally to include the concrete and the sealant, at the very beginning of the planning stages of the project.

Here is the revised version, a simple list:

You must order the lumber, the nails, the concrete and the sealant at the beginning of the project.

Do we need the word the before every item? Grammatically, the choices are to repeat the word the before every item or use it in front of just the first item. Here is how the sentence looks without the repeated the.

You must order the lumber, nails, concrete and sealant at the beginning of the project.

The grammar is correct, but to me, the sentence now sounds too rushed or clipped. It has less of the feel of enumerating multiple items to be ordered. Now it sounds like lumber, nails, concrete and sealant are all one big thing to be ordered as a unit.

At this point, I think the sentence would sound better if we left off even the first instance of the:

You must order lumber, nails, concrete and sealant at the beginning of the project.

This version of the sentence sounds really smooth, but now the implication is that you are ordering general supplies, whereas including the word the meant that you were ordering the specific lumber, etc., needed for the project.

So here we have tried out three different ways to present this list and examined the slight differences in meaning, tone or emphasis. The one thing we cannot do with this list is include the word the randomly for some of the items and not others. You cannot use the on the first, third, and last items, for example, while omitting it from the second item. This rule is called parallelism-items in a list must be parallel in structure. But exactly how you make them parallel is a choice based on meaning, tone and emphasis. 

 

***

Are you an eLearning developer who has been tasked with creating an effective voiceover script? If so, consider attending my Writing Effective eLearning Voiceover Scripts class. I also teach the Writing Training Documents and eLearning Scripts class.

***

About the Author:  Jennie Ruby is a veteran IconLogic trainer and author with titles such as "Editing with Word 2003 and Acrobat 7" and "Editing with MS Word 2007" to her credit. She is a publishing professional with more than 20 years of experience in writing, editing and desktop publishing.

eLearning & mLearning: 2011 Consumer Electronics Show Takeaways

by AJ George Follow us on Twitter

Another year's Consumer Electronics Show (CES) has come and gone. What did this year's CES bring to the table for the eLearning industry?

Tablets

Many have coined 2011 "the year of the tablet"…and I believe it. The iPad has been well received among educational institutions. I think this trend in tablet computing will continue, moving beyond fad and into what could potentially make tablets an essential educational tool, and perhaps even a major money-saver for college students who would otherwise dump a large amount of money into hard-copy textbooks. Even though Apple doesn't show at CES, their presence was certainly felt as the competition scrambled to churn out products that would be able to compete with the ever-popular iPad.

 

Some of the standouts:

 

Motorola Xoom 

 

Blackberry Playbook

 

Notion Ink Adam

 


Tablet Laptops

 

There are still plenty of people who just can't see a place in their lives for a tablet. One of the oft-repeated issues with a tablet is the lack of keyboard. Another issue is the feeling of superfluity of having both a laptop AND a tablet. The Dell Inspiron Duo was a highly anticipated compromise, but unfortunately was met with lackluster reviews. The reviews may have been poor but the idea was solid and many manufacturers threw their take on the tablet/laptop hybrid into the rink at this year's CES.

Some of the standouts:
 

Asus Eee Pad Slider

 

Razer Switchblade

 

Samsung Sliding PC 7 Series

 

Smart Phones

Aside from the Motorola Atrix (which docks to a laptop shell and becomes and laptop itself-cool eh?), there wasn't a whole lot of new news on the smartphone front–mostly just improvements on existing technology and performance. Every little bit, however, brings us one step closer to broader mLearning implementation.

Some of the standouts:

Motorola Atrix

 

Motorola Droid Bionic

 

Vizio Phone

 

Samsung Infuse 4G

 
 

***

About the author: AJ George is IconLogic's lead Technical Writer and author of both "PowerPoint 2007: The Essentials" and "PowerPoint 2008 for the Macintosh: The Essentials."

Adobe Releases Technical Communication Suite 3

Technical communicators can rejoice… the latest version of Technical Communication Suite was just released by Adobe. According to Adobe, version 3 of the suite is a "complete single-source authoring toolkit with multichannel, multidevice publishing capabilities."

Technical Communication Suite 3 includes FrameMaker 10, RoboHelp 9, Captivate 5, Photoshop CS5, and Acrobat X. To learn more about the suite, read the article written by Adobe's RJ Jacquez. To purchase the suite, contact Adobe's Thomas Deems at 206.675.7076.

Adobe Captivate 5: Get Ready, Get Set… Reset!

by Kevin Siegel Follow us on Twitter View our profile on LinkedIn

You can easily add a Table of Contents to your lesson by choosing Project > Table of Contents and then selecting Show TOC.

 

Show TOC

 

Like magic, all of the project slides will be added to the TOC. If you spent the time adding Labels to the slides before accessing the Table of Contents screen, the Labels would appear on the TOC as slide names. You can change the name easily enough by double-clicking any slide name on the TOC and typing a name. If you don't add slide Labels, the name given to each slide is based on the slide number. (Slide 1 will be named Slide 1, and on it goes.)

 

Recently I had a student in one of my Captivate classes ask if she could use her slide labels on the TOC "after the fact." She had added her slide Labels after she had added the TOC. The result of this reverse workflow was that her new slide Labels refused to appear on the TOC, even after she deselected and then reselected the Show TOC check box.

 

The solution to the problem (and it was a problem… she really wanted to use the slide Labels and was dreading having to retype them on the TOC), is simple, yet not obvious.

 

First, add your slide Labels to as many slides as appropriate (select the slide on the Film Strip and then add the label via the Property Inspector's Label field).

 

Open the TOC window and Show the TOC. Then, from the bottom of the TOC window, click the Reset TOC button.

 

Reset TOC button 

 

And BAM! The existing TOC will be replaced and the names of the resulting slides will match the slide Labels. 

 

***

Looking to learn Adobe Captivate 5? We offer Beginner and Advanced classes, as well as a half-day course on Advanced Actions. Both Windows and Macintosh developers can attend these classes.

Adobe FrameMaker: Adding a Drop Cap

by Barb Binder  Follow us on Twitter

 

Adding a drop cap in FrameMaker is easy, right? Just activate the Apply Drop Cap checkbox and specify how many lines to drop down, right? Ha! I wish. Sadly, there is no drop cap feature in FrameMaker, but that doesn't mean you can't have one. You just need to know how to create the drop cap manually.
 

  1. Place your cursor at the beginning of the paragraph where you'd like to have a drop cap.
     
  2. Delete the first character in the paragraph.
     
  3. Choose Special > Anchored Frame.
     
  4. Change the Anchoring Position to Run Into Paragraph.
     
  5. Set the Alignment to Left.
     
  6. Set the Gap to 3 or 4 pts. (The Gap is the space between the edge of the frame and the edge of the text to the right and below the frame.)
     
  7. Set the size to about 1 in x 1 in to start.
     
  8. Click on the New Frame button to add the frame to the paragraph.
     
  9. Open up the toolbox, if necessary via Graphics > Tools.
     
  10. Select the Text Line tool.
     
  11. Click inside the frame and type the character to be used as the drop cap.
     
  12. Format the character using the Character Designer. (If you plan to use more than one drop cap, I'd recommend making a character format.)
     
  13. To finish, drag the letter to the top left of the frame with the Select Object tool and adjust the frame edge to match the size of the letter.
     
Note: 

For more interesting and/or ornate drop caps, consider creating them in Photoshop or Illustrator, and then importing them into the frame. 

***
If you are new to FrameMaker and want to get up to speed quickly, join IconLogic's instructor-led, online Introduction to Adobe FrameMaker class. Hope to "see" you there.
***
About the author: Barbara Binder is the president and founder of Rocky Mountain Training. Barbara has been a trainer for nearly two decades and has been recognized by Adobe as one of the top trainers world-wide.

PowerPoint 2010: Converting Presentations to Movies

by AJ George Follow us on Twitter

In previous versions of PowerPoint, converting presentations to movies could be a bit of a laborious task. PowerPoint 2010 has a new feature allowing presentations to quickly and easily be saved directly to .wmv (Windows Media Video) format .

  1. Open the presentation within PowerPoint 2010.
     
  2. Do a run-through of your presentation to make sure there is an adequate amount of time between slide transitions and any animation effects you may have added and make any necessary changes.

    You won't be clicking your mouse to continue the presentation once it is a movie and you may find that the default transition time goes too fast (or not fast enough) for your liking.
     

  3. Choose File > Save As.
     
  4. From the Save as Type drop-down menu, select Windows Media Video (*.wmv).
     
  5. Click Save.
     
  6. Notice the Creating video progress bar appears at the bottom of your screen. Sometimes this can take a while. Do not close the presentation before the progress bar indicates that it is finished. If you find that you don't want to wait, you can click the red X button to cancel the process.

    Create video progress bar

And that's all there is to it!

 

The good news: In PowerPoint 2007, not only did you need to go in to Windows Movie Maker to convert your presentations to movies, but in doing so you lost any transitions or animation effects you may have added. When you use PowerPoint 2010 to Save As a .wmv file, all of your transitions and animations stay in tact.

 

The not so good news: If you use PowerPoint 2010's new feature allowing for embedding videos from a website, you will find that when you try to save the presentation as a .wmv file, an error message will appear alerting you that this content will not display in your movie. All is not lost. Following these directions, you can take the long way to insert videos from YouTube into your presentation. Using this method will allow you to make a movie from your presentation in which the video will play.

 

Related article: PowerPoint 2007: Adding Voiceover Narration to Presentations Converted to Movies.

 

***

About the author: AJ George is IconLogic's lead Technical Writer and author of both "PowerPoint 2007: The Essentials" and "PowerPoint 2008 for the Macintosh: The Essentials."

Writing & Grammar Workshop: Who versus Whom

by Jennie Ruby

In every custom grammar class I teach, I get a request to review who versus whom. The choice between who and whom is arguably the hardest decision in grammar to make correctly. It can involve identifying subject-verb pairs, understanding the concept of object of a preposition, parsing out clauses that are acting as objects, pinpointing phrases that are acting as subjects, and knowing a little bit about infinitive verbs.

 

But it all comes down to this: is the word who/m a subject or an object in the sentence. To determine whether who/m is a subject, one method is to find every verb in the sentence and figure out exactly what word is the subject of that verb-in other words, identify who or what did that action. If the word who/m is the subject of any verb, the choice is who. If the word who is not the subject of any verb, then it has to be whom.

 

Here are some examples:

 

*Who/m put the sneakers in the dryer?*

 

The verb is put. The word Who/m is immediately before the word put, and is the subject of that verb. Because who/m is the subject of a verb, the correct word is who.


 

Who put the sneakers in the dryer?

 

*He gave the important letter to who/m?*

 

The verb is gave. The word he is the subject of gave. There are no other verbs in this sentence. The word who/m is not the subject of any verb, so the correct choice is whom.

 

He gave the important letter to whom?

 

*I wondered who/m the manager would choose for the new supervisory position.

 

The first verb in the sentence is wondered. The word I is the subject of wondered, so that verb is taken. But there is another verb in this sentence: would choose (a helping verb plus main verb combination). The word manager is the subject of that verb. There are no more verbs in the sentence, and the word who was not the subject of any verb. The correct choice is whom.

 

I wondered whom the manager would choose for the new supervisory position.

 

*She asked me who/m had the best sales record.*

 

The first verb is asked. The word she is the subject of asked. The next verb is had. The word who/m is the subject of had, so the correct choice is who.

 

She asked me who had the best sales record.

 

So far, we have seen only action verbs in the sample sentences. However, nonaction verbs, infinitives, and imperative verbs can be confusing in sentences with who/whom. We will take a look at those next time.

 

In the meanwhile, your homework is to notice any incorrect uses of who/whom you see or hear in the next week, whether they are in the news, in e-mail, on the radio, or wherever. When you find them, correct them, and send them in. I'll share good examples next time.

 

***

Are you an eLearning developer who has been tasked with creating an effective voiceover script? If so, consider attending my Writing Effective eLearning Voiceover Scripts class. I also teach the Writing Training Documents and eLearning Scripts class.

***

About the Author:  Jennie Ruby is a veteran IconLogic trainer and author with titles such as "Editing with Word 2003 and Acrobat 7" and "Editing with MS Word 2007" to her credit. She is a publishing professional with more than 20 years of experience in writing, editing and desktop publishing.

Adobe Captivate 5: Don’t Quote Me!

by Kevin Siegel Follow us on Twitter View our profile on LinkedIn

Prior to publishing a Captivate project, you should spend a few minutes filling in fields you will find in the Project Information window (via File > Project Info).

 

Among other things, you'll find the Project Name and Description fields. Why bother filling out these fields? The Project Name, which can contain spaces, appears in the title bar of the Web browser when the lesson is first opened by your learner. The Project Name and the Description are both read aloud by a screen reader (which is a critical component of section 508 compliance). And any of the information you add to the Project Information can be used by system variables, allowing you to display the information within text captions anywhere in the project. (That's something you learn how to do in my Captivate 5: Beyond the Essentials online class.) 

 

CP5 Project Info.
 

In fact, filling in the fields within the Project Information window is so important, and so simple, I encourage my beginner Captivate students to fill it in as well. (From a beginner perspective, the information can be displayed on a TOC, something you learn to do during class.)

 

So what could go wrong by following my advice and filling in the Project Info? Plenty it appears, such as the error message below:

  

SWF Failed 

 

It seems that fellow Captivate developer John T Wylie Jr., International Game Technology, ran face-first into the error message above when trying to publish. The message refers to actionscript keywords and user variables, but John wasn't using actionscript or user variables.

 

John sent me an email about the problem, but I had never seen that particular error message and, sadly, wasn't able to help.

 

John didn't give up. And he found the cause of the error in an unlikely place. It turns out that John's Captivate project was covering how to use a 103 inch display. In John's Description field, he did something unthinkable: he typed 103" display. Hence the problem. For whatever reason, Captivate does not like it if you use quote marks in the Description field. 

 

 Closed quote in the description

On a whim, John removed the quote mark from the Description field (shown below) and the project published. Go figure!

 

Description fixed

The issue is apparently a bug and is covered in this post on the Captivate forum. A patch has not yet been released that fixes the issue. So until such time that there is a fix, avoid the quote marks. I'd tell you to quote me on that, but I'm not the one who did the work this time… quote John.
 

***

Looking to learn Adobe Captivate 5? We offer Beginner and Advanced classes, as well as a half-day course on Advanced Actions. Both Windows and Macintosh developers can attend these classes.

Writing & Grammar Workshop: Happy New Year! (or is it New Year’s?)

by Jennie Ruby

New Year's Day is the proper noun naming the day we celebrate the new year. That is why it is always capitalized. New Year's Eve is the night before, when all the partying really takes place. When wishing someone a happy new year, the phrase is capitalized and does not need the possessive apostrophe: Happy New Year! Occasionally, you may be using the phrase as an abbreviated form of the proper name of the day: Will I see you on New Year's? is actually short for New Year's Day, or possibly New Year's Eve, and therefore has the apostrophe.

 

Since there is only one New Year's Day per year, you never have to worry about putting the apostrophe after the s. Even when you are thinking back on all the New Year's Days you have celebrated, the apostrophe still goes before the s.

 

Here are some things NOT to do: Don't be like the fellow Billy who is giving us a list on his website of things to do for "New Years." If you are putting the s on New Year, you must use the apostrophe. And don't be like the website for clip art that is advertising "Happy New Year images." That is probably just their database sticking the word images after Happy New Year, but it is grammatically suspect. "Images for Happy New Year" would work better.

As one year ends and another year begins, let's all wish our friends and colleagues Happy Holidays! (no apostrophe) and Happy New Year! with no fear about the apostrophes!

 

***
Are you an eLearning developer who has been tasked with creating an effective voiceover script? If so, consider attending my Writing Effective eLearning Voiceover Scripts class. I also teach the Writing Training Documents and eLearning Scripts class.
***
About the Author:  Jennie Ruby is a veteran IconLogic trainer and author with titles such as "Editing with Word 2003 and Acrobat 7" and "Editing with MS Word 2007" to her credit. She is a publishing professional with more than 20 years of experience in writing, editing and desktop publishing.