Writing Workshop: Write First, Edit Last

by Quinn McDonald


You’ve been asked to write an article on a topic that you both know and like. You sit down to write and… you stop. It’s not that you don’t know how to write, or even know where to begin; it’s more that you are filled with a feeling of dread. What if you forget something you wanted to say? What if you say too much? What if that first sentence isn’t compelling?

 

That’s your editor showing up. Your editor is the one who wants to format, replace, cut, polish. The editor has a critical voice and a sharp X-acto knife for a tongue.

 

The writer part of you wants to get out a lot of information, probably in interesting ways, maybe develop a chart or graph, maybe link to more articles. The writer is dragging in piles of information, colored pencils, games, ideas. The editor is frowning at the mess.

 

How can you be both a writer and editor? The skill sets are quite different, and while I often insist that one person can’t be both, in today’s world, the demand is for exactly those people who are both. How can you handle both?

 

By separating the fighting parties and letting each have some time to work. Let the writer come out first. Move away from the linear-structure of the computer and grab a piece of paper. A stack of index cards is better. Write one idea per card and put it in front of you. Don’t edit, don’t stop, don’t wonder where this will fit. Just keep building the stack, one idea at a time. When you run out of ideas, you will have 20 or 30 cards in front of you.

 

Now feel free to shuffle the cards. Sort them for relevance, for the length of the final article, for sidebars. Shuffle through them to put the most important thing first, along with examples. The final deck should be clean and logical–a story told in pieces on the cards.

 

The computer is now the ideal tool. Start writing, following the outline you created in a free, non-linear way using your cards. Write all the way through. You editor will show up, but assign the editor the task to go ‘tsk-tsk’ at the cards you decided not to use this time around. Finish writing.

 

Now the creative, playful side has had a crack at the article, creating an interesting article with great story-telling and powerful examples. Now it’s time for the editor to come in and tidy up, cut out extra words and stray thoughts, sweep up the mess of wrong punctuation, put in sub-heads with keywords and create a logic thread that runs through the article. If the writer shows up with pictures, colored pencils and games, the editor has the right to ignore the writer or assign a task in another room. Turn-about is fair play.

 

By being the writer first, then the editor, you can benefit from the right and left sides of the brain, the fun and serious side of writing, the exploration of possibilities, and the linear implementation of logic. And you can do it all without having your head explode. A big benefit to people who must write and edit for a living.






About the Author:
Quinn McDonald is a writer and nationally-known speaker who has achieved the “Professional” designation from the National Speakers Association. Contact Quinn through her website, QuinnCreative.com.

Questions of the Week


QuarkXPress Question: What Can I Do About Document Bloat?

 

We are at a standstill with a continuing problem so I thought I’d ask you. Every month when we’re editing our newspaper in QuarkXPress and resave it, the file nearly doubles or triples in size. We can add one word to the file and it will increase the size substantially. Right now, the file is 92 megs and it’s nearly blank.

 

Answer: The AutoSave feature found in QuarkXPress is the likely culprit. This forum discussion may help. 

 

Adobe RoboHelp 7 Question: Is JavaHelp Covered in Your Book?
 

Does your book entitled Essentials of Adobe RoboHelp 7 HTML cover using RoboHelp 7 to create a JavaHelp project? I see where you specifically mention deploying it in a web application, but my application was written using Swing and I just want to make sure that the book covers what I am doing before I buy it. Thanks!
  

Answer:

 

The RoboHelp 7 book does not specifically cover generating JavaHelp. However, it does cover HTMLHelp, WebHelp and FlashHelp. Generating JavaHelp involves the same process as the three I just mentioned, but the JavaHelp format allows for much less functionality than the others.

 

What you’ll learn in my book is how to use RoboHelp to create a help system. Electing to go with JavaHelp, HTMLHelp, WebHelp or FlashHelp is really a decision you’ll make as you create the Help system. When generating your finished Help system, you’ll need to keep your audience in mind, and know the limits of JavaHelp (and not bother adding features to the Help system that will not be supported in JavaHelp).

 

 

Adobe Captivate Question: Can I Quickly Add Navigation Boxes to All of My Slides?

 

I have created a learning module with some menu choices along the top: |Prerequisites | Main | Resources | etc. |. All together I have about 100 slides with the same menu running along the top of each slide. I would like the menu links to all go to the appropriate page in the module. I could do it manually, but that would take quite a long time. I could change each menu link and select apply to all, but that appears to change all the links to whichever one I changed last. Is there any way around this problem?

 

Answer:

 

Create the click box with the link, put it in position and set its properties as appropriate. Then copy the click box to the clipboard. Finally, select all of the slides that need the click box and paste. When you paste, the click box position will be identical on every slide.






Got a question you’d like answered? Email me.

Adobe Captivate 3: Does the Timeline Stacking Order Matter? Yes… And No!

by Kevin A. Siegel


 

I’ve long been a fan of simple Captivate slides. As I’ve said numerous times in this newsletter, less is more. When I produce Captivate projects, I keep the number of slide objects as low as possible. For instance, I try to use just one text caption and one interactive element on a slide (such as a button or click box). I’ve discovered that more slides with fewer slide objects is easier to produce than fewer slides with more objects.

 

Having preached the gospel of “less is more,” I do realize that there are many Captivate developers out there who simply need to insert more than one text caption on a slide. Horrors! Okay, if you really need to do it, go ahead. It’s certainly possible to add 20 text captions to a slide… 60… 100!

 

However (I bet you saw an “however” coming, didn’t you), if you do need to work with multiple text captions on a slide, you should be aware that the vertical order of the text caption on the slide’s timeline might prove important… and might not. Curious? Read on…

 

Consider the image below. I am not trying to trick you when I describe the image below as a slide with three simple text captions.

 

Timeline Stacking 1

 

And here is the timeline for that very slide.  

 

Timeline in logical order

 

The order of the text captions appear to be in a logical order (caption 2 beneath 1, and caption 3 hanging out at the bottom). Does the stacking order shown in the timeline above matter? You could easily drag the timeline object for Caption 3 above Caption 1 and it wouldn’t make any difference. According to the timeline image above, all three captions appear at the same time. But since the text captions do not overlap on the slide, the vertical order does not matter.

 

Ummm… but it does. Maybe. Sorta…

 

Allow me to explain… if you intend to record your own audio for the slide (Audio > Record > This Slide), below is how the text from the captions will appear on the Captions tab. Ooops. It seems like the logical order represented on the timeline is no longer logical. In fact, it looks like the text is presented in reverse. And it is.
 

Timeline Stacking 2

 

Do you plan to add Accessibility text to your slides? If so, an easy way to add the Caption text is to show the Properties of a slide and, on the Slide tab, click the Accessibility button. If you click the Insert slide text button (shown below), your caption text is added to the slide for you… but it is once again in reverse order.

 

Timeline Stacking 3

 

So what’s a developer to do? Simple… think in reverse. Instead of thinking in a top to bottom way, think bottom to top. If you set up your timeline like this…

 

Reverse order... at least it seems that way

 

… the Captions area for new audio will look like this…

 

Audio text in logical order

 

And the Accessibility text that gets inserted will look like this…

 

Accessibility text in logical order

 





Do you have a Captivate production problem that’s making you pull your hair out? Email your problem and let others learn solutions from your experience.

 




 

Want to learn more about Captivate? Click here.

Adobe PhotoShop CS3: Stop the Blinking and Winking


 

Have you ever taken a rapid series of group shots, but can’t find a single image where every single person is looking at the camera, eyes open and smiling? If you are looking for a quick way to combine two mediocre portraits into one perfect portrait, try the new Auto-Align Layers in Adobe Photoshop CS3.

 

Take a look at the two images below. The one on top is better of the boy, but the girl has her eyes closed. In the second picture she looks better, but he’s got one eye closed.

 

There are many ways to combine these two pictures using Photoshop, but the single most efficient technique is to combine both images into one file, each on their own layer. Then, using the new Auto-Align Layers command you can let Photoshop line up both images with each other, and then just use a mask to punch through to the underlying image.

 

Photo Sample 1

 

Photo Sample 2

 

Let’s give it a try…

  1. Open Adobe Photoshop CS3.
  2. Open up two images you would like to combine.
  3. Using the Move tool, Shift + drag one image into the other file. (Using the Shift key as you drag centers the incoming layer in the new window.)
  4. Double-click each layer thumbnail on the layers palette and give each layer a unique name.
  5. Drag the thumbnails up or down, so that the top layer is the better image, but the bottom layer has a better expression on one or more of the subjects.
  6. Select both layers by clicking on one and then shift-clicking the other.

    Select both layers by clicking on one and then Shift+clicking the other

  7. Choose Edit > Auto-Align Layers, and set Projection to Auto. (This allows Photoshop to align two rapid sequence photos, making it easy to remove the goofy expressions from the top layer and expose the better expression from the bottom layer).

    Set Projection to Auto

  8. Intro. level PhotoShop users may opt to use the Eraser tool to carefully erase the girl’s face from the top layer, but for the Intermediate to Advanced user, a Layer Mask is a much better solution because it is non-destructive. To use the Layer Mask, select the top layer, and choose Layer > Layer Mask > Reveal All.

    Layer Mask

  9. Press the letter D on the keyboard to reset your color chips to Black and White.

    Color chips to Black and White

  10. Use the Brush tool with a soft brush to paint away to the underlying layer, exposing the image underneath.

    Brush tool with a soft brush to paint away to the underlying layer

  11. If you remove too much of the top layer, just press the letter X on the keyboard to switch your colors so that White is on top, and paint back in pixels from the top layer.
  12. When everything is perfect, flatten the layers and you have created a fabulous portrait out of two mediocre ones.

    The perfected image

Want more Photoshop tips? Come to my upcoming Introduction to Adobe Photoshop CS3 class on August 4-5, 2008. It will be held in a virtual classroom, so you can attend this live, interactive class from anywhere in the country. All you need is a computer with fast Internet access, a headset and a current version of the software. You can ask all the questions you like because our virtual classes are led by a live instructor–this is not pre-recorded content. “See” you in August!

 




 
About the author:
 Barbara Binder is the president and founder of Rocky Mountain Training. Barbara has been a trainer for nearly two decades and was recently recognized by Adobe as one of the top trainers world-wide for 2007. 

Grammar Workshop: Can I End a Sentence with a Preposition?


 

“This is the sort of English up with which I will not put.” Sooner or later every grammarian ends up either hearing about or citing this sentence, credited to Sir Winston Churchill. Here is my tip-o’-the-hat to it.  Along with other rules that English teachers make up as short-cuts to getting their students to create good English sentences, the rule stating that thou shalt not end a sentence with a preposition, which Churchill was protesting with his convoluted sentence, is a little bit flawed.

 

The flaw is that this rule cannot universally be applied. It is perfectly true that you should not use a gratuitous preposition at the end of a sentence like this: Where is it at? The preposition at is redundant and should be omitted. Without it, the sentence still makes perfect sense: “Where is it?”

 

However, many colloquial expressions require the preposition, and without it the meaning is lost. Here are some examples where you cannot omit the preposition:

 

  • The design was incomplete, so we had to flesh it out. (Out is a preposition and is at the end of a sentence, but without it, the verb flesh makes no sense.)
  • The printout fell on the floor, so I had to pick it up. (Up is a preposition, but without it, pick makes no sense.)
  • The error was so shocking that I had to cry out. (Out, again, cannot be omitted.)

To flesh something out, to pick something up, and to cry out are verb-preposition combos that have unique meanings. Without their prepositions, these verbs have meanings that the reader cannot make out. In these cases, a correctly chosen preposition is a perfectly fine word with which to end a sentence.




 

About the Author: Jennie Ruby is a veteran IconLogic trainer and author with titles such as “Essentials of Access 2000” and “Editing with MS Word 2003 and Adobe Acrobat 7” 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.





Want help with a grammar issue? Email us your troubles and we’ll turn Jennie loose!

Reader Feedback

Jennie’s Grammar Workshop

 

Thanks to Jennie for again making English gobbledygook accessible! Regarding Jennie’s grammar article in the last skills and drills newsletter: I’d heard about the famous “split infinitive” but avoided it like the plague, along with other rules of written English.  As a tech writer (with a programming background), I’m more concerned about effective communication than correctness.  But being a lone writer, I’m expected to be savvy about this stuff.  Now I’ll recognize the phrase when I hear it and respond wisely.  🙂

Questions of the Week


Adobe RoboHelp Question: Why Can’t I Get Help?

 

I’m using Adobe RoboHelp 7. When I try to get help via Help > Contents & Index, nothing happens. Any ideas?

 

Answer: Strangely enough, I’ve received three emails about this very subject this week. The problem is that RoboHelp’s Help System needs a live link to Adobe’s servers to work. If you’re not online, the Help system doesn’t work. No worries. Choose Tools > Options and, on the General tab, select Use Offline Help. Click OK and you should be able to use RoboHelp’s Help system via Help > Contents & Index.

 

 

Adobe Captivate Question: Is There a Limit to How Big my Project Can Be?
 

I keep hearing that there is a size/time limitation when creating a Captivate 3 demo.

Is there a recommendation you have… like make your file only this big in Megabytes or this long and then use the Menu control to link to subsequent movies?
 
I’m getting ready to start a fairly sizeable Captivate 3 project and before I start, it would be great to get this info so then I can create logical breaks and build separate movies to be linked to.
  


Answer:

 

Since users will have to wait until 60% of your published lesson has been download before it will play, I suggest keeping your published SWFs as simple as possible and under 10mb. In addition, there is a limit to how long your Captivate projects play before the Flash player simply refuses to play the published SWF… and the best way to check that is to choose Project > Bandwidth Analysis. On the Project Summary tab, check your Frame count. If it’s larger than 10,000 frames (anything over 16,000 and you’ll likely experience playback problems), try the following:

  • Lower your FPS (Edit > Preferences > Project) to something like 20
  • Simplify your slides (long playtimes and complex animations (such as rollovers) will increase the project’s frame count)
  • Lower the project slide count (I would not recommend Captivate projects larger than 150 slides) 

eLearning Question: Where Can I Find Copyright Blurbs?

 

Is there common copyright language used for eLearning lessons that you can point me to?

 

Answer:

 

I’m not a copyright lawyer, nor do I play one on television. However, I don’t believe the copyright language used for eLearning is much different than the language used for print documentation. There are plenty of free Web resources out there that you can use for more information. This one looks like the real deal.

 

eLearning Question: What are the Rules for Punctuation?

 

Are there rules for using punctuation in eLearning lessons
(specifically periods in text captions)? I’ve heard from fellow writers that periods can be difficult to view in a caption, but I have had no issue with viewing them in produced simulations. Can you provide any further insight?

 

Answer:

 

There is no rule when it comes to punctuation–it’s really a personal choice. The only rule would be to remain consistent–either use end of sentence punctuation or don’t. Personally, I only use end of sentence punctuation if there is more than one sentence.

 






Got a question you’d like answered? Email me.

Adobe Bridge: Create Quick and Easy Contact Sheets for Your CDs


 

How frustrating it is to sort through a stack of photo CDs searching for the one you need, each with a written label like the CD shown below (at left)? Wouldn’t it be cool if you could make a contact sheet (as shown below at the right) that fits in the front of your CD case? Wouldn’t it be even better if the process of creating the contact sheet was quick and painless?

 

Contact Sheet 1
               
Your wish is my command… here is how you do it:

  1. Open Adobe Bridge (the program comes free with Adobe Photoshop and with the Creative Suite).
  2. Navigate to the folder that contains the images you have put on the CD. You can optionally select key images, or make the contact sheet from all the images in the folder.
  3. Choose Tools > Photoshop > Contact Sheet II
  4. Under Source Images, you can select Folder (to generate the thumbnails from all the files in the folder) or Selected Images from Bridge (to generate the thumbnails from only the images you selected prior to opening up the dialog box).

    Contact Sheet 2

  5. Under Document, set the units to Inches, and the width and height to 4.75 x 4.75 (this is the size of a typical CD case). The resolution can be fairly low, i.e., 150 ppi. I prefer to flatten the layers to keep the file size down.

    Contact Sheet 3

  6. Under Thumbnails, decide how many columns and rows of photos you would like on the contact sheet. (Careful here… too many and you’ll need a loop to see them!)

    Contact Sheet 4

  7. Decide if you would like the filename of each file to appear as a caption below each photo. And if so, pick a font and a size. (I chose not to use the captions in my example above.)

It seems to me that most creative professionals are visual folks, and this is a great way to visually catalog your CDs. 


Want more Photoshop tips? Come to my upcoming Introduction to Adobe Photoshop CS3 class on August 4-5, 2008. It will be held in a virtual classroom, so you can attend this live, interactive class from anywhere in the country. All you need is a computer with fast Internet access, a headset and a current version of the software. You can ask all the questions you like because our virtual classes are led by a live instructor–this is not pre-recorded content. “See” you in August!

 




 
About the author:
 Barbara Binder is the president and founder of Rocky Mountain Training. Barbara has been a trainer for nearly two decades and was recently recognized by Adobe as one of the top trainers world-wide for 2007. 

Link of the Week

Visualize Your Web Colors

 

Web designers often struggle with color. Does my table border look good with my page’s text color? Is my heading color too light? Is there enough contrast between the page’s background color and the body text?

 

This might make selecting colors a bit easier… I stumbled upon a nifty web page the other day–IDEO Web Color Visualizer. Using this site, you can click a background color swatch and then instantly see how text of various color would look when paired with the selected background color. Cool! Click here to test the Visualizer for yourself. 

 

Note: IDEO helps organizations innovate through design. Independently ranked by global business leaders as one of the world’s most innovative companies, IDEO uses design thinking to help clients navigate the speed, complexity, and opportunity areas of today’s world.

Questions of the Week


Captivate Question: Is My Patch Bad?

 

Help! I updated my copy of Captivate not too long ago and now my software is acting strange. Every time I make a formatting change to a text caption (I make it bold for instance) and click OK, then open another text caption, all of the text is bold. Is anyone else seeing this? Is there a problem with the patch?

 

Answer: This is indeed a documented problem with the Captivate 3 patch–I’ve experienced the exact same thing. Happily, Adobe is right on top of things and has released a patch for the patch. All you need to do is start Captivate and choose Help > Update to get the new patch.

 

 

Captivate Question: Is it true that Captivate version 4 is Available Now?
 

I attended a trade show recently and was very excited to learn that Adobe has released Captivate 4. Is that true??? I can’t seem to find it anywhere.
 

Answer:

 

Whoa!!!! I’m not sure where you heard that Captivate 4 is available now, but that’s not correct. The most recent available version of the software is version 3. Of course, that’s not to say that Adobe isn’t hard at work on a new version. And before you ask, sorry, but there isn’t an ETA for the release of version 4.

 

RoboHelp Question: Where Can I Find More Skins?

 

I just love the skins in RoboHelp 7. Do you know where I can find more?

 

Answer:

 

Yes, you can download skins from Adobe’s RoboHelp Skin Exchange. Click here to view the available skins.

 

 

Captivate Question: Should “Record Narrations” Be Selected When I Record?

 

If you want to record your narration later, but need to create your project in the meantime, do you check the Record Narrations box initially or not? We are having another person within the company record the narration at a later date.

 

Answer:

 

You would leave that option turned off. Later, during post-production, you can insert audio on the slide or attach audio to any slide object (see my article above).

 





Got a question you’d like answered? Email me.