top browsers – Karen Rempel – New York Senior Technical Writer Team Lead

New York, NY Technical Writer of Extraordinary Ability

I fell in love with New York City (NYC) on my first visit in October, 2014, and moved here from Vancouver in 2017. I petitioned for immigration to the US on my own behalf (without a sponsor or employer), on the basis of being an Alien of Extraordinary Ability (I love that title!) in my field of work, technical writing. The photo above shows my initial application, which was 450 pages long and weighed 8 pounds. Note the patriotic red-white-and-blue color scheme.

I made the decision to immigrate in March 2016, and submitted my application on July 4 of 2016. My application was approved in late December. Super fast! Being accepted for immigration to the United States is a wonderful privilege, and many people helped me by writing letters on my behalf for the application. Thank you all!

From the US Citizenship and Immigration Services website, this is the requirement for the EB-1 employment-based immigration category:

“You must be able to demonstrate extraordinary ability in the sciences, arts, education, business, or athletics through sustained national or international acclaim. Your achievements must be recognized in your field through extensive documentation. No offer of employment is required.

“You must meet 3 of 10 criteria, or provide evidence of a one-time achievement (i.e., Pulitzer, Oscar, Olympic Medal).”

I was able to provide documentation that showed I met not 3 but 8 of the 10 criteria, both in the first submission and in this second submission that provided additional evidence (350 pages, 5 pounds):

This was a rare opportunity to turn my technical writing skills to the task of preparing an immigration petition on my own behalf, and I was accepted as a permanent US resident on this basis. This means the US government considers my technical writing accomplishments to be equivalent to winning an Oscar or an Olympic medal. If you need a rock star technical writer to perform extraordinary technical writing and editing for you, you know who to call!

And if you need assistance preparing your own Alien of Extraordinary Ability application, I can certainly help you with that.

New York, NY Technical Writer Running for Team for Kids

I had a blast last November running in the New York marathon. I exceeded my fund-raising goal for Harlem United, with the help of many generous friends, clients, family members, and colleagues. Together we raised over $3,000! And I ran in memory of David Bowie, which added another special element to the day and made the crowd interaction along the race course even more fun.

I had such a great time that I am running in New York Road Runners’ 9 + 1. That’s 9 races and one volunteer shift in 2017 to qualify for the New York Marathon 2018. I’ll be running a crazy 5 races in June! This will include one in a mini-skirt, a retro run in old-school track clothes, a pride run, a dash through the Bronx, and a special race in Queens where I’ll be raising funds for Team for Kids.

I am thrilled for this chance to support kids to learn the love of running. Something that will last their whole lives and lead to life-long health and fitness. If you’d like to make a donation of $5 or more to Team for Kids, please visit my fund-raising page.

BTW, I just ran in the Central Park Classic 10K last weekend, and the oldest runner, an 82-year old New Yorker named George Hirsch, ran faster than me! So you see, it really is possible to run for a lifetime, for those of us who are lucky.

Save

New York, NY Technical Writer Creates Art Video Project Another New York Love Affair

Although my first passion is technical writing, recently I’ve been developing video skills as well. I am excited to share Another New York Love Affair #25 with you:

I took this footage of the “Sterling Cooper” building in my final week in New York, at the end of March. At the time I was midway through watching Mad Men on Netflix, and in love with the cast of characters. Also in love with New York, and the beautiful strangeness of Madison Avenue. Enjoy!

I am aiming for 100 over the next three years.

New York Technical Writer Teaches Instructional Design for Smartphones

THEY’RE UBIQUITOUS. People—especially technical writers—love their smartphones the world over, from Vancouver to New York, and the smombies are among us! Yes, the smartphone zombies are among us! You’ve seen them—people walking slowly, looking down at their phones, oblivious to their surroundings, possibly risking an accident—an increasingly common social phenomenon.

To smombies, the content on their phones seems more interesting than real life. I did a one-minute video of a New York subway platform, and almost everyone on the platform was looking at their phones while waiting for the train. The situation is becoming extreme. But I understand, because I’m addicted to my smartphone, too! It seems like fun, not work, to learn on a smartphone instead of a computer. So how can we use this technology to teach?

The idea is to design short training pieces that can be delivered via your app or website. Keep the training sessions to 10 minutes or less. Make the training tasks interactive, so people can use the fun features of their smartphones. Deliver some of your content using video—people just love watching video!

Instructional Video Design Tips

Here are some tips for designing effective videos for learning:

Include a title slide for orientation
Use high resolution (1080P HD)
Include still pictures—both iconic (resembling
real objects) and analytic (symbolizing objects
or states)
Include short on-screen texts—labels, call-outs,
short text slides
Facilitate closed captions and subtitling—create
your own or use YouTube’s automated features
Include background music
Eliminate unpleasant background noise (electronic
hums, static, and so on)
Use a speaking rate of 180 words per minute
(faster is more popular than slower)

These 8 tips adapted from Petra ten Hove and Hans van der Meij’s research (2015).

Save

New York Technical Writer Judges STC 2016 International Summit Awards

I was honoured to participate in the prestigious Society for Technical Communication (STC) International Summit Awards (ISA) in two different roles this year. I served as both ISA Competition Judging Manager and as a judge. This meant I had the chance to view an exciting showcase of the top work in the field of technical writing.

The winning entries demonstrated exceptional technical writing clarity, organization, and delivery, with a strong focus on meeting the needs of the end user. The winning entries’ communication delivery methods displayed both brilliance and beauty, with innovative video and voice narration, breath-taking print artwork, and game-changing web-based delivery methods. I felt inspired to see the fantastic work that other technical writers are doing, and look forward to seeing further innovations next year.

Who Can Enter?

The ISA competition is open to entrants who have won a Distinguished or Excellence award at the chapter or regional level. Technical writers do not have to be a member of the STC to enter STC competitions. This year we had entries from North America, Europe, and Israel.

Highlights – Video and Judges

One of the highlights was viewing the video entries. I am very interested in the ways that video can be used to deliver and enhance technical communication. I developed a new set of criteria for judging videos, and will be helping to revise the judging forms for future competitions.

Another highlight was managing a team of 20 experienced and committed judges. I met new technical writers from across Canada and the US, and had the opportunity to both coach and learn as we worked together. In order to meet a very tight deadline, my amazing team judged 34 entries in just over a week. Well done, everyone!

Back to Top

New York Technical Writer Converts to Twenty Sixteen

You might notice my top-ranking Vancouver technical writer site looks a little different today. I updated to the WordPress twentysixteen theme. You may recall I gave an enthusiastic shout-out to WordPress last May, when I updated my site to use the twentyfifteen theme. I still think WordPress is awesome, and it would appear that website builders the world over agree with me. As of today’s date (February 6, 2016), 59.1% of websites in the world use WordPress, according to W3Techs.

It was a snap to make the change, taking about 2 hours total to select the theme, install it, create a few graphics in the right size, and make a few minor formatting tweaks. I added my own copyright information to the footer, customized the link font colour, and changed the font size for the tags in the left column. This is an amazing accomplishment (on the part of their coders to make the task so easy), and I am very appreciative of the service that WordPress provides for free to the world computing community.

I made these changes using a combination of the user-friendly WordPress editing platform and direct coding in the .php and .css files.

While I was at it, I took a look at my Google Analytics for the site. I thought it would be fun to compare the stats from the past month to the stats I reported in May 2015:

Device	May 2015	Feb 2016
Desktop	918 – 92%	936 – 89%
Mobile Phone	70 – 7%	92 – 9%
Tablet	15 – 1%	26 – 2%
Total Visitors	1,003	1,054

The table above shows that the percentage of mobile users has increased slightly. Still, the majority of people who searched for a technical writer used their desktop computer, which makes sense. I imagine people would prefer to do this at work, not while lounging on the beach!

Browser	May 2015	Feb 2016
Chrome	729	702
FireFox	115	127
Safari	72	108
Internet Explorer	31	90
Other	56	27
Total Visitors	1,003	1,054

No changes in the browser pecking order either, though the use of Internet Explorer did increase significantly.

I welcome your thoughts on the new site design. Drop me a line!

Back to Top

Save

New York Technical Writer Updates to Twenty Fifteen

Thanks for visiting my revised website! Hi, I’m Karen Rempel, a Vancouver-based documentation specialist and senior technical writer.

I just updated this website to be mobile-friendly using the fantastic WordPress theme Twenty Fifteen. I also updated my BC Wilderness Visions website, using the same theme but different settings. Check it out to see the striking effects that can be achieved by simple colour changes.

I want to give a big shout-out to WordPress for this awesome theme. It only took me a day to update both websites to use this theme. I was previously using Silver Light by Blog Oh! Blog. I loved this theme and didn’t want to change, but Google forced me into action by notifying me that my Google ranking would slip if I didn’t make my site resizable for mobile phones and tablets. What can you do?

I checked out my Google Analytics for the past month, and found that of the 1000+ visitors to this technical writing website:

918 used desktops. This is what I thought! My clients are typically at their desk at work when they think about their need for a technical writer, do a search, and call me.
70 used their mobile phones.
15 used their tablets.

Technical writers bridge people and technology

So isn’t it interesting that people use technology to find technical writers? Most of my clients find me by searching on the internet. And thanks to Google Analytics, I know which devices they use, what countries they search from, and even what browser they use!

Here are the stats for browsers used to find this technical writing website:

Chrome – 729
FireFox – 115
Safari – 72
Internet Explorer – 31

Please drop me a line to let me know what you think of the new site! And if you like, tell us what device and browser you used to get here. 🙂

Back to Top

New York Technical Writer Advises Using MadCap Flare Content Management for Customized Resumes

I recently completed a technical writing project for a Vancouver- and Calgary-based client who is a management consultant, program manager, and project manager in IT. Like many consultants, he has worked in a range of industries, and with over three decades’ worth of experience, he faces the challenge of condensing his experience and skills into a 3-page resume targeted to clients in two provinces. What would be a good way to solve this challenge? Enter MadCap Flare.

[Click the graphic to see a larger view that shows the use of condition tags]

Often thought of as an online help authoring tool, MadCap Flare is also a very user-friendly content management system (CMS). It provides a wide range of online and print-based output options (for example, Word, PDF, html). It uses XML as the backbone, making it easy to import source content and play nicely with most of the industry-standard authoring tools on the market today.

I thought that MadCap Flare’s CMS capabilities could help solve my client’s problem by providing a single-source database of skills and experience from which he can output a role- or industry-specific resume with one or two clicks of the mouse. In the words of our beloved Captain Jean-Luc Picard, I made it so.

I imported my friend’s main resume from Word, and then added in content from five other role-specific resumes, with conditional tags indicating which content belonged on which resume or CV. I set up two different style sheets, for two different looks – executive dark blue, and executive brown. I set up variable text for his phone, email, and mailing address, so he can select which of these to use on a given resume for a particular client. Then I created target outputs for nine different resumes. Et voila!

All my client has to do is click Build Primary and then select the resume he wants to generate. But best of all, updating his resume with new experience is a snap. He can use MadCap Flare’s intuitive XML editor to type in new content, then apply conditional tags to specify which resume the content belongs with. Then simply use those same two mouse clicks to generate his new target resume. Beautiful. As you can tell, I am a fan of the Flare!

Of course, MadCap Flare isn’t cheap—a perpetual license is over $1,000 CAD (including tax). But for professionals who are aiming for top-paying consulting jobs, it is a reasonable career investment, and a tax write-off. If you are interested in creating your own database of role-oriented, industry-specific resumes, give me a call and I will be happy to help you.

Back to Top

Save

New York Technical Writer Teaches Simultaneous Desktop and Mobile Design

I recently launched a new website for a Vancouver- and New York-based technical writing client. I designed and created the site using the WordPress theme Twenty Fourteen, which has been optimized for desktop, tablet, and mobile phone. Twenty Fourteen reorganizes the display of page elements based on the screen size of the device you are using. In contrast, the theme for this karenrempel.com technical writing website, Silver Light by Blog Oh! Blog, was developed in 2008 and does not resize on the fly. [Note: I updated karenrempel.com to a mobile-friendly format in April 2015.]

But there’s more to designing for mobile devices than just the capacity to automatically adjust the page elements. Here are some tips about mobile design for technical writers:

Keep the number of menu items to 6 or less. This is the maximum that can be displayed without scrolling on an iPhone.
Don’t use submenus. They are shown in expanded view when you open the menu on a tablet and present the reader with an overwhelming number of choices.
Use center alignment for graphics. Left or right alignment with text wrap leaves a column that’s too narrow for displaying text elegantly.
Put the phone number and action links near the top of the home page. Imagine your user is stopped at a light and wants to find the info before the light turns green! Not that anyone looks at their phone while driving, of course.
Launch all top-priority pages from links in the home page.

Whether you are a technical writer designing a website for a client, or designing your own technical writing website, I hope these tips will help you design a site that’s effective—both visually appealing and functional—on any device.

Back to Top

Save

New York Technical Writer Provides Windows 8 Work-Arounds

Having your computer die is one of those love it-hate it moments in life. There’s the excitement of getting to go out and spend a lot of money on electronics without guilt—we need our computers! There’s the thrill of seeing what’s new and great, and the promise of way more storage capacity and lightning-fast processor speeds. But if you use your computer for business, as I do for my technical writing business, there is the downside of the downtime, and the need to make a decision quickly and get back up and running ASAP.

My computer doctor Dave at Eltek Electronics, who gave me the news about the death of my old motherboard, warned me about Windows 8. He said try before you buy, so like a good technical writer I went to the London Drugs at Granville & Georgia, and spent a few minutes there looking at the new operating system, but it didn’t really register, what with the sales guy hovering around and telling me about fans and gaming speeds (very helpful info, and I love the quiet fan on my new laptop).

So it wasn’t until I brought my Dell Inspiron 15 home that the impact of Windows 8 really hit me. Start screen? What? Email login? What? Apps? What? No Start menu? What? Charms? What? Microsoft Security Essentials is gone? What? I was in for a week of googling to find out how to make my computer my own, with a pre-Windows 8 functional desktop. I must say, the internet community is awesome (full of excellent technical writers!), and I found everything I needed to know, from how to make changes to the registry to a free download for a Start menu simulator. So here are some tips, in case you find yourself in a similar situation, and like me, are in love with the old world ways.

Start Menu 8 – Free download, choice of which Windows-era Start menu button you want to use, access to Control Panel, Shut Down, Computer properties, Devices and Printers, and you can pin anything you want to the first page, just like in Windows Vista. Also provides the capability to disable the Windows 8 Start screen. Love it! CNet gives it 4 out of 5 stars. I give it 5.

Windows Essentials 2012 – If you have old emails from Windows Mail that you want access to, you need this software package, which includes Windows Live Mail, the replacement for Windows Mail. Includes Microsoft Silverlight (required for viewing web content on some sites), if you haven’t already downloaded it.

Malwarebytes Anti-Malware – My computer doc recommends this as the best free anti-virus software. I’ve been using it for years. He also recommends using Firefox (not Internet Explorer) to minimize infections. But you probably already know that.

Disable Upgrade Prompts – If you are like me and don’t want to be interrupted by annoying prompts to upgrade to Windows 8.1 (with no visible way to close the prompt and return to work—I had to use Ctrl-Alt-Del and shut it down with the Task Manager), this blog describes how to create a registry key to turn off the upgrade prompt.

BTW, if you are using regular Windows 8, the Group Policy Editor is not available. A lot of tips describe how to set up Windows 8 using the GPE, but it’s only available if you have Windows 8 Pro. So look for instructions that use the Registry Editor instead.

Disable Lock Screen – To go directly to the desktop when you start your computer, the lock screen is one of the screens you can eliminate. Follow the instructions in this blog entry to add a key to your registry to disable the lock screen.

Run box – If you are a real techie you already know this, but half-techie technical writers like me might wonder where the Run box has gone and how to get to it when you first start Windows 8. The Windows key+R opens the Run box. Once you install your new Start menu, it’s in Windows System > Run.

Windows Defender – Microsoft Security Essentials is now called Windows Defender. Unfortunately, there is no way to add this to the right-click menu to scan individual files. But you can use it to do full-computer scans. It’s in the Windows System folder on the Start menu.

I hope this will help my technical writing friends and clients get up to speed on Windows 8 and minimize downtime on your next computer upgrade.

Back to Top