Writing & Grammar Workshop: Premise vs. Premises

by Jennie Ruby View our profile on LinkedIn

OK, I know we all love the police talk. Law & Order, CSI, COPS, etc. have made police blotter jargon extremely popular. Legalistic language is everywhere. You can even hear little kids saying things like "Please move your vehicle" and moms saying "You have parked your bicycle in an illegal manner." I get it. I understand. I just read a Grisham novel myself. But let's try to at least impose a modicum of grammatical correctness while we are making statements like this: 

 

"The perp was apprehended on the premise/s."

I have seen the singular form of the word premise incorrectly used to mean a home or place of business at least 10 times in the past two weeks. Here's how it works: a premise, the singular form of the word, is a proposition or a kind of hypothesis. It is a working supposition one uses in logic problems. And of course, you can have several propositions, or premises.

That's where the legal term enters. The premises are the preexisting properties–grounds and buildings–upon which a lease or mortgage is based. In this sense, the plural word premises is always used. A good memory aid is to substitute the word grounds where you would use the word premises.

They found the miscreant on the grounds.

 

They apprehended the perp on the premises.

The first sentence means they found the person on the lawn or on the property surrounding a building. Notice that if you substituted the singular word ground, the meaning would be completely different. Then it would mean they found the person maybe either lying on the ground or on foot, rather than, say, in a car or helicopter. Similarly, if you used the singular word premise, the sentence would nonsensically mean that they found the perp on a logical proposition.

Now that you know what is what with this word, I am betting you will notice people using it incorrectly in the news, in print, on the radio. One last note: when you hear television police officers or newscasters use the word, you might hear them pronouncing it "premisis." There is no such word.  

 

***

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 RoboHelp 9: Content Categories

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

RoboHelp has allowed you to create conditional build tags and expressions. If you've never used them, they let you generate multiple layouts from one project, each potentially containing unique content. But what if you wanted to take multiple layouts, combine them into one, and then let your users decide which layout they want after they access the Help system? That's the perfect scenario to use RoboHelp's new Content Categories.

First, create conditional build tags and apply the tags to topics and content within your Help system. In addition, create TOCs and Indexes as necessary for each layout. You'll also need to create the build tag expressions to be used with each Content Category. (Each of these steps are covered during my two-day RoboHelp class.)

 

Apply a build tag to a RoboHelp topic.

 

Create Content Categories

  1. On the Single Source Layouts pod, show the Properties of your layout.

     

  2. Select Content Categories and click the New button. (You can create as many categories as you need.)

     

  3. Give the category a name and press [Enter].

     

  4. From within the Content Categories group, select your new category.

     

  5. Change the Content Title, select a Table of Contents and a Conditional Build Expression.

    RoboHelp Content Categories

     

  6. Save and Generate the layout.

     

  7. From the upper left of the Navigation pane, you will see a content drop-down menu. You can select any of your layouts from the menu.

    RoboHelp Content Categories drop-down menu. 

 

***

 

Looking to learn RoboHelp, and fast? I'm teaching a live, online class that will give you the most essential RoboHelp skills… and in just two days.

Adobe FrameMaker: Templates

by Barb Binder  Follow us on Twitter View our profile on LinkedIn

At least one student in every one of my Adobe FrameMaker classes inquires about templates. And why shouldn't they? Templates are the single best way to get a jump start on the design of a new document. In FrameMaker, there are two different locations for the templates that come with the software.

Start by exploring the standard templates:

  1. Choose File > New.
     
  2. Click the Explore Standard Templates button at the bottom of the dialog box.

There are two screens of templates that represent a variety of business documents. I have to admit that they are not the most attractive designs, but don't discount them. Because they demonstrate a wide variety of FrameMaker features, the templates that ship with FrameMaker are a great learning resource for you. Take the outline templates for example. Numbered paragraphs tend to be one of the hardest things for new users to figure out. If you open up these templates and look over their formatting properties, it all becomes very clear.

If you are still looking for inspiration, FrameMaker 9 and 10 ship with additional templates, but you have to know where to look.

In FrameMaker 9, you will find them in:

C:\Program Files\Adobe\Framemaker9\samples\More Samples

And for FrameMaker 10, you will find them in

C:\Program Files\Adobe\Framemaker10\samples\More Samples

There are five categories of templates just waiting for you to find them: Books, Data sheets, Reports, Education and Special. Go explore! 

***
If you are new to FrameMaker and want to get up to speed quickly, join IconLogic's instructor-led, online Adobe FrameMaker 9 or 10, Introduction 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.

Featured Online Classes

Adobe Captivate 5: Essential Skills

During this live, interactive two-day and instructor-led class, you will get an introduction to Adobe Captivate 5 and learn the core, essential skills that will help you create killer eLearning lessons.

 

Some of the lessons covered in this course:

  • Best practices for eLearning
  • Recording Demos and Sims
  • Adding animation and Flash Video
  • Recording voice-overs and adding sound effects
  • Publishing as SWF and other formats 

Instructor: Kevin Siegel

Click here to learn more or to sign up.

***

Writing Training Documents and eLearning Scripts

Created in response to inquiries by IconLogic's audience (including former students), this course quickly gets your writing compass pointed in the most productive direction. Whether you're writing technical documentation, training curriculum and materials, or eLearning scripts, this intensive course delivers instruction and practical experience on critical topics including:

  • the writing process and structure
  • identifying and thinking like your audience
  • facilitating the conversation between SME's and the reader
  • promoting the "WOW" factor
  • keeping "the voice" active, accurate… and short
  • avoiding common grammar mistakes
  • identifying and eliminating deadwood
  • writing narratives that will "hook" your audience
  • writing step-by-step procedures that make the most of the learner's time and effort

Instructor: Jennie Ruby 

 

Click here to learn more or to sign up.

Writing & Grammar Workshop: Infinitives and Who versus Whom

by Jennie Ruby View our profile on LinkedIn

 

To be, or not to be, asked Hamlet, making those two infinitives among the most well-known phrases in English. An infinitive is a verb form with the word to in front of it, in the form to verb. To be, to think, to ski, and so on.

We use these verb forms as nouns, as adverbs, and as adjectives. But one thing is for sure: these verb forms are never used as the verb in a sentence, and therefore will never have a subject. That is why if the word who/m happens to be in front of an infinitive, it is not the subject of the infinitive.

Here are some problem sentences:
 

He wondered who/m to hire as the new ski instructor.

 

Jimmy asked who/m to ski behind.

 

They told us who/m to see to order the new equipment.

To determine whether to use who or whom, you try to figure out whether the word who is the subject of any verb. In all of these examples, the word who has a verb form immediately after it. But those verb forms are all infinitives. And since infinitives do not have subjects, the word who is not the subject of any of them. Since who is not the subject of any verb in these sentences, all of them should say whom:
 

He wondered whom to hire as the new ski instructor.

 

Jimmy asked whom to ski behind.

 

They told us whom to see to order the new equipment.

The whole infinitive thing is just one more reason who versus whom is one of the hardest parts of English grammar. Just remember–an infinitive never has a subject. 

 

***

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.

ASTD’s TechKnowledge Book Discount

We are having a really great time at ASTD's TechKnowledge conference in San Jose!

What's more, the bookstore quickly sold out of our Captivate books!

167981_10150108288239617_503754616_6031214_5909021_n

Did it sell out before you got there? Are you totally bummed? No worries! Use the links below to order at the TechKnowledge discount by entering code TK11 at checkout. (Orders must be placed before close of business Friday, February 4th.)

Adobe Captivate 5: The Essentials or Adobe Captivate 5: Beyond the Essentials

Adobe RoboHelp 9: External Content Search

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

The two most commonly used features in a Help System are typically the Index and Search tabs. One of the limitations of the Search feature has always been the inability to hook specific URLs to Search terms. I'm happy to say that the External Content Search feature puts that issue to rest in the new RoboHelp 9.

Using External Content Search, you can display content from specific URLs based on terms that users are likely to search. For instance, a company called South River Technologies (SRT) has a Help system and they would like to set it up so that if a user searches for the word webdrive (one of SRTs products), they'll be presented with a link that will take them to a web page showing the word webdrive as it relates specifically to South River Technologies.

If you were SRTs Help author, here is how you could set up the External Content Search in RoboHelp 9.

Using your web browser, go to http://www.google.com and click the Advanced Search link. In the all these words field, type webdrive; in the this exact wording or phrase field, type south river technologies and from the Language drop-down menu, select English.

Google Search

Click the Advanced Search button and only web pages that contain the word webdrive and the wording south river technologies will be listed. Select and copy the URL in the address bar to the clipboard (you will be pasting it within RoboHelp shortly).

Add External Content Search

Using RoboHelp 9, choose View > Pods > Project Setup. Double-click External Content Search to open the External Content Search dialog box.

Click the Add button. Change the Title to webdrive. In the Search Terms field, type webdrive. In the URL field, delete the current entry and paste the URL that you copied from the Google Advanced Search. In the Description field, type Search the web for the term webdrive as it relates to SRT.

Add External Search to a RoboHelp project

On the Single Source Layouts pod, double-click your layout and select the Search group. Then select Enable External Content Search.

Enable External Search

Click the Save and Generate button and, when ready, click the View Result button. On the Search tab, type webdrive and press [Enter]. Click the lone result to display the Google Search results.

The thing that I really found cool about RoboHelp's External Content Search, especially using a Search engine results URL, like the one you copied from Google, is that the results will automatically update for your users when Google's search algorithms get updated (which is frequently).

 

***

 

Looking to learn RoboHelp, and fast? I'm teaching a live, online class that will give you the most essential RoboHelp skills… and in just two days.

Adobe Captivate 5: Keep Audio From Getting Cut Off

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

When importing voiceover audio into Adobe Captivate, I always suggest that audio be added directly to the slide instead of objects on the slide (Audio > Import to > Slide). Why? By importing audio directly onto the slide, you'll have more direct control over the audio. You will be able to edit the audio clip by double-clicking the waveform on the Timeline. And you'll be able to control when the audio begins to play by simply dragging the waveform left or right on the Timeline.

 

Which brings me to the subject of this week's article. In the image below, a voiceover clip has been added to a slide, and the audio has been set to play just when the slide appears.

 

Audio waveform

 

While allowing audio to play when the slide appears on the learner's screen isn't wrong, there is a potential drawback… the first syllable of audio can get cut off.

 

Solving the problem is simple. Drag the waveform right on the Timeline so that the voiceover is delayed by a fraction of a second or so (as shown in the image below).

 

Audio delayed

 

While it may not seem like such a big deal, even a slight audio delay can prevent the first part of clip from being dropped after the slide has appeared.

 

***

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.