Search This Blog

09 February 2011

Writing "Warmly"

Reference: I read an article about techinical writing skill, it advised to write in warm words, i have no idea what does the warm words mean? does it mean short sentences, very concise, no big words? Technical Writer group, LinkedIn.com. 18 January 2011.

Jiawei, a technical writer from China, wants to know what "warm words" means. Other writers haven't heard this term used. Jon guesses that it means words that make the reader feel included and able to relate to the article. Doug guesses that it means stating the goal of a procedure before listing the instructions. Nick things it refers to ambiguous words that convey a warm feeling. Ray said it was nonsense. Most agreed that warm words have no place in technical writing.

I think "warm words" can mean writing in a friendly, understandable way. In English, we try to write as an equal to the reader and assume that the reader welcomes the information or instructions we provide. As part of this, it can also mean using humor and conversational words.

I think "write warmly" can mean writing as though the reader is your equal and welcomes your instructions. It can also mean using humor and conversational words.

I learned from my wife's uncle, a Ukranian Jew who survived Hitler's death camps, that many languages such as Russian have different ways to state the same thing to different people.

For example, the same statement, "The thermometer reads 98.6 degrees" might use different sets of words when addressing a superior, an equal, a subordinate, a customer, or a child. Learning such differences can be like learning different dialects. I think this is also true of Japanese.

I've seen attempts to carry over excessive politeness in Asian instructions written to American consumers. English generally lacks such differences. Most English-speakers have a distaste for class distinctions. Writers need not say,

  1. Please use the video cable to connect the DVD player to the TV.
  2. If you wish, you may plug the DVD player's power cord into the wall socket.

Rather, the writer may address the reader as an equal and as somebody who wishes to be told what to do.

  1. Using the video cable, connect the DVD player to the TV.
  2. Plug the DVD player's power cord into the wall socket.

Those who dislike being told what to do (in other words, men and teenagers) will ignore the instructions, so the writer cannot offend them.

A variation on this theme: While you should assume that your readers want you to tell them what they need to know, do not assume that you know their mind. You do not want to alienate readers by making them feel like you judge them or like they are dumb.

Note the mild humor I injected about how men and teenagers dislike taking orders. I do not suggest using humor in cross-cultural writing. It's too easy to make mistakes. I have seen web pages devoted to collections of embarrassing mistakes in English signs designed by non-English speakers.

However, I will often use mild humor (sparingly) to make text more interesting. I believe that when readers enjoy reading my text, they will be more likely to read, will read more of it, and will read more carefully.

Conversational text means using terms easy to understand. Avoid slang, buzzwords, and big words where smaller, more common words will suffice. Use acronyms only after you have spelled out what they mean, only if you need to use the terms more than a few times, or only if "every" potential reader understands them (such as DVD and TV). Above all, never use abbreviations normally used in cell phone text messages! I hate when people do that on LinkedIn! You want your reader to understand without having to interpret.

If you word your technical writing as though you write for equals who want you to tell them what to do, take a risk with a little mild humor once in a while if you know the readers' culture, and use a conversational style as much as possible, your writing will become "warm" and enjoyable.

21 January 2011

Four More Tips for Using Social Media in Job Hunting

5 Tips to Keep Your Head Above Water with Social Media
by Laura Click, founder of Blue Kite Marketing
Guest post on the blog of Dr Shannon Reece
21 December 2010
I’m at a turning point in my approach to job hunting. The referenced article (above) reinforced my decision. The article aims at a wide audience (points #3 and #5 have the most value for me), so I'd like to apply it more narrowly to my comrades in the unemployment line.
  1. Perfect your profile. Your profile on an SM site is your resume. Make sure it shines when recruiters find it.
  2. Search for the best way to locate open positions. Learn to use Twitter’s search function and to find job announcements in LinkedIn groups.
  3. I get a lot of self esteem from helping people by answering questions, but the ROI is zero. Figure out what activities do and do not get you interviews.
  4. The recommended half day is way too much time to put into social media. Allocate more than a half hour only to activities that produce leads.
Social Media and job-hunting experts have repeatedly told me to use SM to help people so somebody will notice and help me. I give up on that. Or, at least, I’m going to apply that advice a lot more narrowly.

16 January 2011

Recruiters - What to Expect

Reference
Two Types Of Recruiters – Retained and Contingent
Brad Remillard
IMPACT Hiring Solutions
Undated; downloaded 16 January 2011

Summary of the Article

Recruiters contract to find applicants on behalf of hiring companies. Two major categories dominate: Retained, and Contingent. They may be a convenience, a connection to that job you need so badly, but neither works for you. They work as hired guns for the employer.

Retained recruiters get paid 2/3 of their fee whether or not the company hires the applicant. They only get the final 1/3 if there's a hire. They also offer guarantees to their clients (the employers), so if a new hire doesn't stick around, the recruiter has to return part of the fee and loses a bit of his reputation and future business. An employer won't want to pay multiple fees for each employee, so he will contract only one retained recruiter.

Retained recruiters protect their business by getting to know a company's culture and job requirements and by obsessing over finding the perfect match. Expect a thorough, frustrating screening and then having to repeat the process with the hiring company. They also submit only a few resumes, so the applicant competes against
only a few others; but the others have gone through the same screening and match the job well, too.

Contingent recruiters get paid only if you're hired. No matter how many contingent recruiters submit applicants, the company only pays one, so a whole squad of recruiters might go out looking with a single position to fill. If two submit the winning applicant's resume, the first one gets the fee. This put them in competition, so they collect resumes for fast submission and skimp on niceties like pre-screening.

Applicants relying on contingent recruiters compete against the larger number of applicants from multiple recruiters and have lower likelihood of fitting the job; but other applicants are less likely to fit the job, too. Applicants don't go through dual screenings, and their names get in front of the employers sooner, but they experience more of the black hole effect, never hearing back from the recruiters.

Also, once a contingent recruiter has your resume on file, he might submit it to companies without your knowledge. This can complicate your search if employers get tired of seeing your resume submitted for positions for which you don't qualify.

When dealing with a recruiter, ask how his client compensates him and how he will use your resume later.

26 December 2010

The TSA Guide to Password Security

Inspiration: Walsh, Ivan. The Mel Brooks Guide to Super Strong Passwords. Business Plans for Smart People. Posted 25 December 2010, downloaded 26 December 2010.

This year, we learned about the TSA patting down five-year-old Christian boys, strip-searching sixteen-year-old girls, x-raying congressmen and celebrities, and sending 56-year-old rape victims into flashbacks and panic attacks, while waving-through young Muslim men and protesting imams.

In the spirit of shutting the barn door after the cows have already escaped, we can learn fine lessons from the current administration about how to set up strong passwords.
  • Always make passwords no more than six characters in length so you can type them quickly.
  • If you absolutely must use an acronym, use an obvious one like rotflmao or wysiwyg.
  • Use just lower case letters in your passwords. No need to use mixed case, numbers, or annoying symbols that require using the Shift key.
  • Using a combination of letters, numbers, and symbols will just confuse you.
  • Don't make embarrassing spelling mistakes.
  • Substituting look-alike numbers or symbols in your passwords (for example, pa$$word or V1agra) will make you feel clever.
  • If you use multiple words, make them easy to remember by using common terms or phrases like threeamigos, myhump, or JoeSchmoe (or whatever your name is).
  • Use familiar, publicly available terms such as your name, address, high school, or Twitter ID.
  • Another clever password consists of a sequence of letters or numbers, such as 123456, abcdefg, or qwertyu.
  • Even more clever, you could combine the name of the website with an easy-to-remember sequence, such as facebook123.
  • Birthdays, family members' names, and celebrities' names are perennial favorites sure to stir sentimental memories.
  • Nobody would ever guess a word spelled sdrawkcab!
  • Just in case you need to remember a password when you're not at home, always store a list of all your passwords online.
  • Once you establish a great password, why ever change it? Hackers would never collect information about you or use one account to exploit other accounts before doing something obvious.
Finally, relax! Forget about Wikileaks, hundreds of millions of stolen credit card files, hacked Facebook accounts, and spyware-infected computers. Enjoy life. Hackers who figure out your password for one account would never figure out that it works for all your other accounts, too.

23 December 2010

E-book Reader You Already Have

You don't need a Kindle or Nook to read e-books. You can use the screen and computer you're using right now.

By downloading appropriate software, you can use your desktop or laptop computer to download, manage, and read e-books without shelling out even more money for a Nook or Kindle. I like that I could copy-and-paste from a book to an article that I'm writing in Word -- a great advantage over having books on e-readers.

Of course, you won't want to carry your laptop to the beach, the batteries won't last as long as in an e-reader, and it won't be easy to read outdoors as on one of those paper-like screens. On the other hand, you can't read those paper-like e-reader screens in dim light, and you might need that extra money for keeping the lights on.

If you already have an e-reader, don't worry about transferring books. Once you purchase an e-book, you can read it on either your e-reader or on your computer.
  • The Barns and Noble website offers free Nook software so your iPad, iPhone, Android, Blackberry, Mac, or Windows computer (including desktops, laptops, and netbooks) can access the Barns and Noble on-line bookstore. The software permits highlighting, taking notes, and creating bookmarks as you read, and you can sync bookmarks between different devices. B&N claims to have more than twice the library that Amazon has.

    Nook books use files in the .epub and in Palm's eReader PDB formats. Nook e-readers can download newspaper and magazine subscriptions, but B&N's website does not clearly state that the Nook for PC software has that ability.

  • The Amazon website offers free Kindle software so your iPad, iPhone, Android, BlackBerry, Mac, Windows Phone 7, or Windows (including desktops, laptops, and netbooks) can do what a Kindle does: access Amazon's on-line bookstore and read your purchased e-books. The software permits highlighting, taking notes, and creating bookmarks, as well as synchronizing your highlights, notes, and bookmarks with your other devices.

    I really like that the Kindle software has a built-in dictionary. You select a word in the text and get the definition. Great idea, but I doubt the dictionary has that great a quality. Besides, you could always open your favorite browser and search on "definition [big word]".

    Kindle books use files in Amazon's .azw format, plain text .txt files, and Mobipocket's .mobi and .prc formats. That means you can find more e-books on sites such as Fictionwise, Mobipocket, Webscriptions, and Project Gutenberg. Beware, though: Books from other sites such as Mobipocket won't work if they have DRM (Digital Rights Management) protection, even though, ironically, Amazon owns Mobipocket.

  • Nook and Kindle e-readers and software can display files in Adobe's .pdf format, but not reliably. They can't display some graphics, formulas, and tables.

    No problem! Your computer should already have Adobe's free Adobe Reader. If not, use the link I just gave you to download and install it.

  • Recommendation: A lot of e-book file formats exist. Calibre (they spell it with a lower-case 'c') provides one solution for Macs, Linux, and Windows computers. Their free e-book viewer software (donation requested) can manage libraries of e-books having a number of formats. Calibre can also convert files between a number of common formats. Since you can download e-books from Amazon and B&N with your browser, you might not even need to bother with their software.

    The B&N software can sync e-books on your computer with your Nook, and Amazon software can sync them with your Kindle. If you have them. Calibre works with the Nook and Kindle, too... but it also supports Android phones, Apple iPhone and iPad, Airis dBook, BeBook/BeBook Mini, Binatone Readme, Cybook Gen 3/Opus, eClicto, Ectaco Jetbook, Entourage Edge, Foxit eSlick, Hanvon N515, Irex Illiad/DR1000, Iriver Story, Italica, Kobo Reader, Longshine ShineBook, PocketBook 360, SONY PRS, SpringDesign Alex, and the Teclast K3.

    Remember that the free Adobe Reader still is the best software for reading .pdf files.
I have resisted getting an e-reader. I have too many books waiting on my bookshelf to be read and too many informative articles available through my browser to consider an e-reader to be a worthwhile purchase.

However, I have downloaded many free books that are formatted for e-readers, so I need appropriate software. If you're like me, you will find the recommendation above to be your best solution.

20 December 2010

Keeping Up with the Geeks

I love technology, but I hate the pace at which application software evolves. Just about the time I develop enough expertise to be the office go-to guy, the game changes.

You can keep up with some technology all of the time,
and all of the technology some of the time,
but you can not keep up with all technology all of the time.
 -- with apologies to Mr. Lincoln

Mitigation plan: Choose a niche or two and focus, focus, focus. 

11 December 2010

Which Browser to Use?

Reference:  Purdy, Kevin.  Browser Speed Tests: IE 9 Beta, Firefox 4 Beta, Chrome's Crankshaft, and Opera 11 Beta. Lifehacker.com, 10 December 2010.

Kevin Purdy ran benchmark tests on Chrome, Opera, Firefox, and Internet Explorer. He scored them university-style against the total number of points they could have received and ranked them.

Purdy should have included Apple's Safari. It is popular enough to deserve inclusion.

He also should have rated the browsers on security or borrowed ratings from elsewhere. However, I speculate that he might not have done so because he was concerned only with performance. Security also depends on the use of anti-virus and anti-spyware applications such as my favorites, Microsoft Security Essentials, Spybot Search & Destroy, and Lavasoft Ad-Aware. In fact, security depends so much on security tools and on security awareness that the security of browsers may be a wash.

Not satisfied with Purdy's scoring method, I created a table and assigned my own scores (1 to 10, with 10 being best) to the performance of each browser.

Click on the table to see a larger view.

Purdy did not list results for Internet Explorer in the Memory Use with Extensions test. I assume this is because you can't use extensions with IE, or at least not the same ones available with other browsers. That reflects very poorly on IE's flexibility, so I don't feel bad giving it a score of zero.

Purdy did not list results for Opera 10.63, either. I assume Opera 10.63 had issues similar to IE's limitations. However, since Opera 11 has a score, some functionality must be there for 10.63, so I gave it a 1. Give me a reason to change it and I will.

Next, I ranked the tests in order of importance and assigned weights to them.


I made a decision matrix spreadsheet, normalized the weighted scores, and found the following results.


Or, if you prefer a bar chart....

Click on the figure for a larger view.

Surprisingly, my scores did not greatly differ from Purdy's.

Chrome and Opera have the best performance, with Google Chrome 10 winning by both Purdy's scoring and by my weighted scoring. If you use Firefox, you can do better (although you may prefer the add-ons that are available for it). If you use MS Internet Explorer, you can do a lot better.