Writing & Grammar: Acronyms–Are they Both Efficient and Clear?

by Jennie Ruby

I have been told, and have taught, that you define an acronym on first use if it is used at least once more in the document. But during a recent class one of my students opened my eyes to thinking further about acronym use. Writers and editors at her agency, she said, have a policy that if an acronym is not used at least five times in the text, they do not use the acronym at all.

That policy struck me at once as being so sensible that I immediately adopted it for my own use. Why make your reader have to search back for where an acronym was defined if you have used it only twice in the entire document? Just spell it out the second time. Unless the acronym is more frequently used in the world than the spelled out words are–like CSS instead of Cascading Style Sheets–the meaning is going to be clearer if you spell out the words.

Another student sent me some text that used an acronym to refer to a group of people. The acronym referred to a medical condition, but it was along the lines of defining Microsoft Word Users as MWUs. The people were then called MWUs throughout the text. This immediately struck me as dehumanizing and disrespectful, especially since guidelines about talking about people with disabilities recommend always using the word people or person, as in people with asthma instead of asthmatics, to avoid characterizing people as totally defined by their disease. It seems even worse to define people as acronyms.

Good writing is both efficient and clear. Use of acronyms may seem very efficient, but that may be at the cost of clarity. Spelling out more words and phrases instead of using acronyms may make the document longer, but it may actually increase efficiency if it means the reader does not have to stop and go back to reread what an acronym stood for.

At their worst acronyms can make a document seem overly technical, or even exclusionary, as readers who are not very familiar with the acronyms struggle to derive meaning from terse groups of letters. 

So for now, I am going with the "used at least five times" rule in my work. Let me know what you think. Does your office have a policy like this? Do you use a lot of acronyms? Do you avoid them? I would love to hear from you.

***

My next live, online grammar class is a one-day review, May 10. Bring your actual problem sentences, hyphenation questions, and other grammar conundrums and have them answered once and for all. Sign up now to allow time for your copy of Abrams' Guide to Grammar to arrive before the 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 FrameMaker 10: New Support for Drag and Drop

by Barb Binder  Follow us on Twitter

I was walking to my airline gate recently and overheard an elderly woman complaining to a younger woman as they passed me. All I heard was, "Why do they give us so many ways of doing the same thing?"

 

Who knows what she was talking about, but it made me smile because I hear the same thing all the time in my various Adobe training classes.

 

One of the (many) benefits to having spent so many years delivering software training is that I've had the opportunity to observe all of the various learning styles and workflow techniques. I try to let each of my students know early on that even though some of us might be dedicated right mouse button clickers, others (like me) prefer keyboard commands, and still others like to rely exclusively on the menus. It's all good… we can still be friends. My statement usually diffuses the otherwise inevitable frustration that can accompany learning more than one way to do the same thing.

With that thought in mind, let's discuss FrameMaker's drag and drop feature. It's just another way to move (or copy) text and elements. To move something, just select it, press down on your left mouse button, and drag the text or element to its new location.

 

If you'd prefer to copy, just hold down the Control key and do the same thing. (If you see a question mark, FrameMaker is telling you that you are trying to move/copy your object to an invalid location.)

Dragging and dropping also works within column rows and tables, as long as you add the Alt key to move and Control + Alt to copy.

And as long as you purchase FrameMaker 10 within the next fifteen minutes (I'm just kidding!), you can also drag and drop across other applications that support the drag and drop feature.

As I said earlier, I'm a happy keyboard shortcut gal… the drag and drop feature isn't likely to change the way I use FrameMaker. I'm betting that some of you are going to love the drag and drop feature and begin using it right away. That's okay. We can still be friends.
 

***

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.
***

 Looking to learn Adobe FrameMaker We offer Beginner and Advanced classes.

Adobe Captivate 5: Nervous About Editing Your RDL? Dupe It… But Watch the Name

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

Back in March I wrote an article about editing Captivate's RDL files to control much of the text and punctuation that will appear in a project's text captions before recording any of your lessons. That little trick will surely save any Captivate developer hours of work.

During one of my recent Advanced Captivate classes, a student asked if it was possible to make a copy of an RDL file, make changes (for instance, maybe have one RDL that featured end-of-sentence punctuation and one that didn't) and then have them both available within Captivate.

The answer was a resounding YES and I went about demonstrating how to do it for the entire class. First, I opened the default Captivate RDL file (CaptureTextTemplates_English.rdl) using Notepad. I gave the file a new name (kevin_test_english.rdl) and then added end-of-sentence punctuation to several lines of text.

Then it came time for the big finale. I saved and closed the kevin_test_english.rdl file and started Captivate. I went to the Preferences dialog box (Edit menu for Windows users; Adobe Captivate menu for Mac users), selected the Recording category, selected the Generate Captions in menu and… and… the pesky RDL file was not in the menu.

So there I was, scratching my head and trying to figure out why my RDL file wasn't available in the menu. Thankfully, my classes are online and without video cameras so my students couldn't see me sitting there all slack-jawed. I honestly had no idea what I had missed and wondered if I was seeing some kind of bug. Mind you, I had performed this steps dozens of times over the years and the new RDL file always showed up in the menu.

And then of my students came to the rescue. Dave Previdi, a Business Systems Consultant with Wells Fargo, reminded me of a key step in the process that I had forgotten. The name you give to the RDL is critical. I had named mine kevin_test_english.rdl, which is all wrong. The name must be CaptureTextTemplates_name.rdl. I changed the RDL file name to CaptureTextTemplates_Kevin.rdl and all was well with the world (in the image below, you can see my Kevin file is available in the Generate Captions In drop-down menu). Rock on Dave!

RDL file available in the Language list

 

***

Looking to learn Adobe Captivate 5? We offer Beginner and Advanced classes. Both Windows and Macintosh developers can attend these classes.

Adobe FrameMaker 10: Repeat the Last Operation

by Barb Binder  Follow us on Twitter

Here's another simple, yet powerful feature that is new in FrameMaker 10. If you pull down the Edit menu and start reading from the top, you'll find Undo, Redo, History and then new Repeat command. Its job is simply to repeat your last activity. This includes:  

  • Type text
  • Paste
  • Delete
  • Apply a character format
  • Apply a paragraph format
  • Insert a graphic object (i.e., Arc, Ellipse, Group, Inset, Line, Math, Polygon, Polyline, Rectangle, Rounded Rectangle, TextFrame, TextLine, and Unanchored Frame)
  • Insert a table
  • Set Object Properties
  • Set text properties (i.e., Plain, Bold, Italic, Underline)
  • Insert Footnote/Anchored Frame
  • Find/Change
  • Apply a condition tag

The two items I care most about personally are applying character and paragraph formats. When I'm tagging a long document, I'd much rather tag the first Heading1 for example, and then just tap F6 (that's the Function key shortcut for Edit > Repeat) to tag the remaining Headings. Being able to repeat Object Properties on multiple frames is a close second.

How do you use the Repeat command? We'd love to hear from you.

Note: There are a variety of activities that you can perform that will stop the Repeat function in its tracks. Click here for the complete list.

***
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.

 

***

 

Looking to learn Adobe FrameMaker We offer Beginner and Advanced classes.

Adobe Captivate 5: Display Resolution and Snap to… Watch ’em Both

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

I received an email from a fellow Captivate developer who was distressed. He had captured several software simulations using Captivate's Application option. He had a huge monitor and had maximized the application he was capturing. And he had Snapped to the Application window. 

In the image below, I've set my Captivate Recording Size options to match his options (except I was capturing Notepad). Notice that I've selected both Application and Application window.

 

Capturing an Application window

 

Why the developer's distress? A lesson recorded at a higher resolution, and set to capture a maximized Application window, will result in one very large video. Sure enough, the developer's customers soon complained that they had to scroll way too much to interact with his simulations.


Selecting the options mentioned earlier isn't necessarily wrong, assuming you don't make the Application window too big… and that your display resolution isn't too high. 

 

What perplexed the developer was that the published videos looked perfect on his computer. He learned too late that most of his customers had smaller displays and lower resolutions. Since he recorded his Captivate videos using a maximized Application window, and he had a higher resolution than his learners, they were not able to see his entire video screen without the dreaded scrolling.

 

I told the developer how to resize the projects smaller (Modify > Rescale Project). While the technique worked, there was a drawback: the screen icons, which were already on the small side because of his high screen resolution, were now much too small for the average person to read.

In the end, the developer's boss insisted that the lessons be re-recorded at a lower display resolution and smaller Snap to area. Ouch!

 

To ensure that you don't find yourself in a similar situation, I offer the following information about Screen (Display) Resolution and the Snap to area. I'd recommend that you review this information before you record a single video using Captivate.

 

Screen (Display) Resolution

 

A computer monitor is measured in pixels–a little square that is the basic component of any computer graphic. If a monitor is set to show more pixels, it is known as increasing the resolution. Graphics look better, but smaller. The fewer pixels you request, the lower the resolution, and the larger the screen elements appear.

 

Consider the following Web browser statistics (compiled by w3schools.com):
  • Mozilla FireFox is the most popular web browser at 43.5%
  • Internet Explorer is second at 25.8% followed closely by Google Chrome at 25%.
  • Safari (the Macintosh browser) is a distant fourth at 4% 
  • Most computers today are using a screen resolution of 1024×768 pixels or higher.

While the last bullet above says that "most computers today are at 1024×768 or higher," you will need to know what is typical at your organization and take that resolution into account. And keep this in mind: a learner with a display resolution setting of 1024×768 pixels, and a maximized browser window, will only have approximately 1000×700 pixels of usable screen space left when you factor in typical toolbars and scrollbars.

 

Snap to

The Snap to area is the part of the screen that you will be recording (also known as the Recording Size or area). When you record a Captivate video, you will see the Snap to area as a red box on your screen that includes resizing squares.

 

You can select several Snap sizes from the drop-down menu and, assuming you haven't selected Application window, you can stretch the Snap area to any custom size you need. Most of the lessons that I record use one of two Snap sizes: 640×480 or 800×600. Either of these sizes result in published videos that view well over the web or an intranet.

 

Custom sized capture area

 

The Bottom Line:

 

I recommend that you record your Captivate videos at a display resolution setting that matches the display settings of a typical learner in your organization. In addition, a Snap to area of 800×600 is ideal, assuming the application you are recording comfortably fits inside an 800×600 window. If it won't, use the smallest Recording Size that will work. When it comes to the Snap to size, I typically tell my Captivate students and developers that they should capture the smallest possible area of their screen, but that they should go as big as needed to get the job done… just not too big.

 

Writing & Grammar: Name That Error–The Answers

by Jennie Ruby

Here are the answers to last week's grammar challenge. Were you able to name the errors? Did you fix them correctly? Some of these problems may have more than one correct answer. For example, the sentence fragment can be corrected many different ways. If you have questions about any of these, I would love to hear from you.

  1. Using the new iPad app, the best erosion control method can be found quickly.

    Using the new iPad app, engineers can find the best erosion control method quickly. You can correct this dangling participle by adding a subject that is described by the introductory participial phrase.

  2. A basic telescope can allow you to see Jupiter and its moons but for more distant objects such as the Crab Nebula you need more serious gear.

    You can correct this run-on sentence by adding a comma after moons.

     

  3. The new second-generation processor delivers improved resolution, it transforms your ordinary video into a stunning feast for the eyes.

    You could correct this comma splice by changing the comma to a semicolon.

     

  4. Improving the computer's speed on benchmark tests by only 2.4%, graphics were still slow to upload after the upgrade.

    The upgrade improved the computer's speed on benchmark tests by only 2.4%, so graphics were still slow to upload. You could correct this misplaced modifier by moving the word being modified closer to its modifier. In my correction, I converted the modifier phrase starting with improving into a complete clause by adding the word upgrade

     

  5. To prevent hacking of the present system and work toward a long-term solution while saving money along the way.

    We can prevent hacking of the present system and work toward a long-term solution while saving money along the way. You can fix this sentence fragment by adding a subject or by adding a complete independent clause.

     

  6. While one may need an industrial-grade personnel training solution in the long term, you can still address basic needs with an entry-level system today.

    While you may need… I fixed this unexpected change in person by changing one to you to match the pronoun you in the second part of the sentence.

     

  7. This training forum allows you to discuss newly developed materials, upload samples for beta testing and to receive detailed feedback from your colleagues.

    You could fix this lack of parallelism by adding the word to before upload. And depending on your style guide, you might add the optional serial comma after testing.

  8. Building management gave the task of self-publishing the materials to all of the development office staff, including myself.

    You can correct the incorrect pronoun usage by changing myself to me.

 

My next live, online grammar class is a one-day review, May 10. Bring your actual problem sentences, hyphenation questions, and other grammar conundrums and have them answered once and for all. Sign up now to allow time for your copy of Abrams' Guide to Grammar to arrive before the 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 FrameMaker 10: Why Should I Care About the New Background Color?

by Barb Binder  Follow us on Twitter

Some time ago, a client was considering using Adobe FrameMaker for a project and wanted to be able to electronically highlight text. That existing version of FrameMaker couldn't do it so the client decided to use Adobe InDesign. Because of that one incident, I was keenly aware when Adobe added background colors into FrameMaker 10.

In FrameMaker 10, you can now add a background color behind your text through both the Paragraph and Character Designers. This would have solved my student's highlighting needs. He could have set up a character format called Highlight, and then used it to highlight strings of text.

 

Character tag named Highlight

 

Resulting highlighted text in the FM document.

OK, that takes care of that one application, but what else can you do with a background color when highlighted text isn't a priority?

My personal favorite is to use it for a condition tag indicator. I was never a fan of using underlines, strikethroughs and overlines as a style indicator, though I certainly understood why I needed to. With FrameMaker 10, I'm happy to retire the lines and switch to colors.

 

Condition tag background color.

Speaking of colors, I always add a color to my user variables so that I can keep an eye on them during layout and editing, even when I'm zoomed out. Now I can use a background color instead.

 

User variables color.

But the real reason I think Adobe added support for background color is for PDF comments. This has got to be one of the most life-changing features for me. (I'm referring to importing PDF comments, not specifically the new support for background color within PDF comments.) If you are using FrameMaker 9 or 10 and don't know about it, definitely take five minutes to read about it here. We can now import comments that have been added with text highlights in Adobe Reader or Acrobat, and not just the basic editing tools.

 

PDF colors. 

***
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.

Adobe Captivate: No More Autosizing, Thanks!

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

Maybe I was imagining things… but I set a pesky text caption to a specific size. Later on, when I re-opened the slide, the caption was much smaller. I attributed the episode to drinking too much coffee.

But then it happened again!

I resized a text caption to a very, very specific size–no doubt this time. At some point I used the spell check feature (Project > Check Spelling). There was a typo flagged in that very same caption, which I naturally allowed Captivate to fix. And bam! The caption resized.

Has this happened to you? It's not a bug… it's not your caffeine intake… it's a feature… and one that I'm not very fond of. If you resize a text caption or button in Adobe Captivate, and then edit the object's text at all, the object will do you a favor and resize. If you're someone who doesn't appreciate this particular kind of "favor," here is how you disable the feature.

  1. Display Captivate's Preferences (Edit menu for Windows users; Adobe Captivate menu for Mac users).

     

  2. From the Global group, select Defaults.

     

  3. From the General area, consider removing the check marks from Autosize Buttons, Autosize Captions and Calculate Caption Timing.

    Disable the autosize feature in Captivate.

    With these three options disabled, Captivate will no longer resize your objects and change object timing on the Timeline. Careful though. From this point forward, it's possible that your captions can be too small and that the end of the text can get cut off. You'll need to ensure the captions are big enough to accommodate the text. On the other hand, you'll be able to return to your previous caffeine level. 

    Note: The General preferences you set above will not affect legacy projects. If you set the preferences prior to creating a project, all new projects will follow the preferences. The existing projects will need to be altered, one at a time. 

***

Looking to learn Adobe Captivate 5? We offer Beginner and Advanced classes. Both Windows and Macintosh developers can attend these classes.

Writing & Grammar: Name That Error

by Jennie Ruby

"Why did you change my sentence? I liked it the way it was." If you edit other people's writing, you will face this question at some point. To be prepared to answer it, you need to know the names of common grammar errors that a writer can make. And, of course, it helps to know how to fix them. Here are some examples of sentences with problems. Can you name the grammar and punctuation errors? Can you fix them? I'll bring you the answers next week.

  1. Using the new iPad app, the best erosion control method can be found quickly.

     

  2. A basic telescope can allow you to see Jupiter and its moons but for more distant objects such as the Crab Nebula you need more serious gear.

     

  3. The new second-generation processor delivers improved resolution, it transforms your ordinary video into a stunning feast for the eyes.

     

  4. Improving the computer's speed on benchmark tests by only 2.4%, graphics were still slow to upload after the upgrade.

     

  5. To prevent hacking of the present system and work toward a long-term solution while saving money along the way.

     

  6. While one may need an industrial-grade personnel training solution in the long term, you can still address basic needs with an entry-level system today.

     

  7. This training forum allows you to discuss newly developed materials, upload samples for beta testing and to receive detailed feedback from your colleagues.

     

  8. Building management gave the task of self-publishing the materials to all of the development office staff, including myself.

My next live, online grammar class is a one-day review, May 10. Bring your actual problem sentences, hyphenation questions, and other grammar conundrums and have them answered once and for all. Sign up now to allow time for your copy of Abrams' Guide to Grammar to arrive before the 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: SWFs Not Playing in Articulate Presenter? Here’s Why…

This question came in last week:

Question: I have a question about Adobe Captivate 5 and Articulate Presenter '09.   After adding Captivate 5 SWFs into Articulate Presenter, the SWFs do not play. Everything worked with our Captivate 4 SWFs. Do you know if there are compatibility issues?

Answer: The issue is with AS2 vs. AS3. Captivate 5 SWFs only publish in AS3. Articulate Presenter requires AS2. Review this article for details.