Order in the Sentence: Introductions


The basic sentence in English is noun-verb-object: The player hit the ball. But we seldom leave it at that. We add things on the front. We add things on the back. We interrupt the sentence to say something else, and then come back to the sentence. We vary the basic sentence structure. And, in the most extreme cases, we substitute other things for the noun, the verb, and the object. All of this gives us great flexibility in creating sentences, but this very flexibility leads us to the problem of which variation to choose, and why.

Let's look at introductory elements. Placing an introduction on the front of the basic sentence can do some important things. It can tell the reader when the sentence occurred or applies:

  • At the bottom of the ninth, the player hit the ball.
  • After tone adjustment, the screen displays more accurate colors.
  • When you receive this error message, click OK.

 
An introduction can tell the reader how much credence to give the information:

  • Supposedly, the player hit the ball.
  • As we all agreed, the large type was more readable.
  • In every case, the deadlines were met.

 
Introductory elements can provide a transition from the previous idea or concept to the next one:

  • We all expected the game to end with the next pitch. However, the player hit the ball.
  • The default setting is 12-point Roman, nevertheless, Arial is the preferred typeface.

 

An introduction should not present information that the reader cannot use or interpret before reading the rest of the sentence:

  • In the File, Insert, View, and Tools menus displayed at the top of the screen by default when the default settings are in effect, side menus are present.

 
Here the reader has to absorb an entire list and a condition before knowing why these are being listed. Instead, put the explanatory information first, and then the list:

  • Side menus appear in the File, Insert, View, and Tools menus.

 
Some of the information that was supposedly introductory was actually worthy of a sentence of its own:

  • These menus are displayed at the top of the screen when the default settings are in effect.

 
Remember that introductory elements have specific purposes, and avoid using them to do the work of presenting the bulk of the information in your writing. Use sentences for that!

***

Join Jennie online where she'll be teaching Writing Training Documents and eLearning Scripts.

*** 

 

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. Jennie specializes in electronic editing. At the American Psychological Association, she was manager of electronic publishing and manager of technical editing and journal production. Jennie has an M.A. from George Washington University and is a Certified Technical Trainer (Chauncey Group). She is a publishing professional with 20 years of experience in writing, editing and desktop publishing.

Adobe Captivate 5: Sneak Peek!

by Kevin Siegel

I'm attending Adobe's Learning Summit
in San Jose right now. RJ Jacquez, Senior Product Evangelist just wowed
the crowd with a sneak preview of the upcoming Adobe Captivate 5 for
the Macintosh.

Here are some of the highlights:


  • Captivate
    is being recreated from the ground-up. The new software is being
    written in C++ instead of Delphi (which was the programming language
    used for the other versions of Captivate). As a result, the Macintosh
    and PC versions will be the same.

  • Captivate 5 works natively on a Macintosh. If you are a Mac fan (like me), this is a huge, huge deal! Sweet!!!!
  • Captivate 5 features the same common user interface as the
    other Adobe applications. For instance, can dock panels anywhere on
    your screen. Once you set up your screen the way you like, you can save
    the environment as a Workspace. From that point forward, you can
    quickly switch between one Workspace and another.

  • There won't be any dialog boxes in Captivate 5. For the first
    time, you will use pods (available in your workspace) to change the
    properties of selected objects.

  • While recording, you will now see a countdown (3-2-1) just
    before the recording begins. Nice improvement since in the older
    versions of Captivate you weren't always sure when the recording
    process actually began.

  • For the first time, you can work in one Captivate project,
    open another or create a new Captivate project and move content between
    the open projects.

  • Improved Photoshop support. While you could import Photoshop
    files and include the layers in Captivate 4, the process has been sped
    up so much that if you blink you'll miss it. This is a nice improvement
    over Captivate 4.

  • Insert multiple Question slides at the same time. The improved
    Question Types dialog box got the biggest applause during RJ's
    presentation. You can now elect to add 3 Multiple Choice questions, 2
    True/False slides, etc. Anyone who has had to add question slides, one
    at a time, knows how cool this new feature is.
***



Looking to create killer eLearning lessons with Adobe Captivate? Join one of IconLogic's classes, or contact us for custom group or onsite training rates. Click here for more information about our 2-day Captivate Essentials class. Looking for more Advanced Captivate 4 training? We have you covered. Click here for more information.

Worried
about your class canceling? You'll be happy to hear that we never, ever
cancel our classes (even if there's just one student registered).


***


Follow Kevin on Twitter: http://twitter.com/iconlogic.

Acrobat 9: Keyboard Shortcuts Galore

by David R. Mankin, the Acrobat Czar

The Czar! While casually scanning the constant flow of Twitter topics this afternoon, something caught my eye–a quick promise of a free collection of Adobe CS4 keyboard shortcuts brought me to the Adobe Student Hub. It seems that Adobe is offering substantial discounts on their software to qualifying students — "Adobe Student Editions software is for use by higher education students only." Fair enough.

The site is annoyingly noisy (IMHO), and you can turn off the crazy electronic throbbing noise by clicking on the tiny speaker icon on the left (whew).

Front and center is the Adobe Shortcut App. You can try this handy device live on the sight, as the site's whole 3D interface is Flash. Adobe Shortcut App contains keyboard shortcuts for ALL CS4 Apps! This is beyond convenient, since we tend to specialize in a program or two, but sometimes need to work with one of the suite's other programs.

Adobe Shortcut App

Click the CS4's individual program's icon at the top of the Shortcut App, and you are presented with appropriate keyboard shortcuts! Here's the best part: this cool application can be downloaded as an Adobe Air application! For me, this one's a keeper. Poke around at the site's other features. There's a Job Feed App to help you find a job using Adobe's awesome tools too.

What's the catch? Well, the cool, free Adobe Shortcut App is a billboard which will always remind you of Adobe's terrific student pricing on the app–no big deal, considering how useful this free download can be!

***

Looking for Acrobat training? We run an online Acrobat class once each month. Click here for more information and class dates.

***
 
About the author: In addition to recently being named the nation's Acrobat Czar, David R. Mankin is a Certified Technical Trainer, desktop publisher, computer graphic artist, and Web page developer. And if that wasn't enough, of course David is an Adobe-certified expert in Adobe Acrobat.

Question of the Week: Adobe RoboHelp Projects… How Big is Too Big?

Question:

My team and I are preparing to work on projects in RoboHelp 8 and are looking into how to best publish the files. We're very interested in FTPing because it would give us the flexibility to publish on our own without depending on IT for deploying the !SSL files to the intranet (I have used FTP before, and it worked very well). However, we will need to request some server space so we can FTP our projects to an IIS server, but we are not sure how much IIS space to request. So, my question is, in your experience, is there an "average" MB per published project? In my own experience, the average published project has about 300 files (around 3.5 MB), and doesn't contain many attachments or graphics.  I don't foresee our team having more than 10 RoboHelp projects to publish, and I think we would be safe in asking for 5 GB of space (10 at the most) for the published files.

Also, is there a recommended limit on the MB size for a RoboHelp project? At which size would they become "clunky," and what would the !SSL size be for a project that big??

Answer:

That's a tough question to answer emphatically. The output folder within your SSL will get bigger depending on two things: the number of topics and, more telling, the number of images, audio files and animations you add to those topics.

In any event, you can get an exact size of your output folder with a simple right-click on the folder within the SSL folder after you generate. When you Publish the folder to your server, the storage requirements will be the same as the size of the output folder. As for exact size requirements for the space on your server, a few gigabytes should suffice for now (unless your project contains thousand of topics). As for RoboHelp projects that are too big, I wouldn't worry about project size unless your project has more than two or three thousand topics.

Writing & Grammar Workshop: Department of Redundancy Department

"Double your pleasure, double your fun" may be a good thing when it comes to chewing gum, but in writing it may be a distraction–or worse–an error. Expressions such as past history, future prospects, and serious crisis are redundant, but so popular that many readers won't notice them.

Redundancies such as a double negative (don't have no) or the reason why is because are noticeably wrong.

In business or technical writing, stay away from is is and does is, as in "What it is, is larceny." Instead, eliminate the introductory clause and go with "It is larceny." Instead of "What this does is it gives you another option for…" go with "This gives you another option for…."

When explaining reasons for something, go with "The reason is that…" or "You do this because…" to avoid incorrect redundancy.

Hidden redundancies occur with abbreviations: CRT tubes, LCD displays, and PIN number all have a repeated meaning: the T stands for tube, the D for display, and the N for number.

Eliminate redundancies from your writing for enhanced clarity and conciseness. And remember to watch out for redundancy when you are using your PIN number at the ATM machine and you reflect back on your past experience with new innovations.

***

Join Jennie online where she'll be teaching Writing Training Documents and eLearning Scripts.

*** 

 

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. Jennie specializes in electronic editing. At the American Psychological Association, she was manager of electronic publishing and manager of technical editing and journal production. Jennie has an M.A. from George Washington University and is a Certified Technical Trainer (Chauncey Group). She is a publishing professional with 20 years of experience in writing, editing and desktop publishing.

Twitter Best Practices

RJ Jacquez, Senior Product Evangelist at Adobe, is quickly becoming one of the best known and prolific TechCom and eLearning Tweeters around. He's had so much success with Twitter, RJ has created a running list of Twitter Best Practices.

Says RJ, "This list has worked for me and I hope that it will work for you too. I will continue adding to this list, so please consider following me on Twitter @rjacquez for new updates to this list."

Adobe Captivate 4: Shortcuts Anyone?

by Kevin Siegel

I can't tell you how many times I've been asked if there was a list of keyboard shortcuts available to make some of the cool things Captivate can do a little bit faster.

There is, and here it is…

File Menu
Open Ctrl + O
Close Ctrl + W
Save Ctrl + S
Import Audio To Slide F6
Preview Slide F3
Preview Project F4
Preview From This Slide F8
Preview Next 5 Slides F10
Preview In Web Browser F12
Publish Shift + F12
Print Ctrl + R
Edit Menu
Copy Slide Ctrl + C
Duplicate Slide Ctrl + D
Delete Slide Del
Copy Background Ctrl + Shift + Y
Select All Slides Ctrl + A
Find and Replace Ctrl + F
Find Background in Library Ctrl + Alt + F
Go To Slide Ctrl + Shift + G
Preferences Shift + F8
View Menu
Full Screen F11
Magnification 100% Ctrl + 1
Magnification 200% Ctrl + 2
Magnification 300% Ctrl + 3
Magnification 400% Ctrl + 4
Best Fit Ctrl + 0
Insert Menu
Blank Slide Ctrl + Shift + J
Question Slide Ctrl + Shift + Q
Random Question Slide Ctrl + Q
Image Slide Ctrl + Shift + S
PowerPoint Slide Ctrl + Shift + P
Animation Slide Ctrl + Shift + N
Text Caption Ctrl + Shift + C
Highlight Box Ctrl + Shift + L
Rollover Caption Ctrl + Shift + R
Rollover Image Ctrl + Shift + O
Rollover Slidelet Ctrl + Shift + Z
Zoom Area Ctrl + Shift + E
Text Entry Box Ctrl + Shift + T
Click Box Ctrl + Shift + K
Button Ctrl + Shift + B
Widget Ctrl + Shift + W
Text Animation Ctrl + Shift + X
Image Ctrl + Shift + M
Animation Ctrl + Shift + A
Flash Video Ctrl + Shift + F
Mouse Ctrl + Shift + U
Slide Menu
Hide Slide Ctrl + Shift + H
Lock Slide Ctrl + K
Slide Properties Ctrl + Shift + D
Audio Menu
Record F5
Import F6
Audio Management Alt + Shift + A
Speech Management Alt + Shift + S
Quiz Menu
Question Slide Ctrl + Shift + Q
Random Question Slide Ctrl + Q
Question Pools Manager Ctrl + Alt + Q
Project Menu
Actions Shift + F9
Check Spelling F7
TOC Shift + F10
Skin Editor Shift + F11
Advanced Interaction F9
Window Menu
Timeline Ctrl + Alt + T
Library Ctrl + Alt + L
Slide Notes Ctrl + Alt + N
Filmstrip Ctrl + Alt + B
Design Templates Ctrl + Alt + V
Comments Ctrl + Alt + X
Widget Ctrl + Alt + Z
Help Menu
Help F1
Recording 

Stop recording

End

Pause or resume recording

Pause
Capture a screenshot manually Print Screen
Start full motion recording F9
Stop full motion recording F10
Automatic panning F4
Manual panning F3
Stop panning F7
Snap the recording window to the mouse F11
Toggle mouse capture in full motion recording F12