25 Years and Still Going Strong

It was 25 years ago today that my first article, “The Forgotten Chips,” was published in Byte Buyer magazine in San Diego. A good friend, Wally Wang, encouraged me to write it and even helped me put it together. It seems that IBM managed to leave quite a few important chips out of the original PCs design in order to offer a hobbled system at a price they thought everyone would pay and I was upset about it. Never, in my wildest dreams, did I imagine that I’d still be writing articles 25 years later. I can honestly say that I’ve never tired of writing articles—not that every article is easy or even well written. The best articles have been difficult to research and write, and sometimes the editor has to work mighty hard to turn my prose into something worthy of the reader’s attention. Still, this first article is special and only someone who has had something published can understand how I felt when I saw it.

ForgottenChips

It never occurred to me that I would eventually write books. In fact, this first article was slated to be my last. Wally encouraged me to write other articles after the first article turned into a success and I’m happy he did. In fact, we wrote our first five books together. However, the first book, “Illustrated VP Expert,” wouldn’t be finished until mid-July 1988 or accepted by the publisher until August 1988. So, this first article was followed by quite a few more before that first book happened.

IllustratedVP_Expert

I’m currently working on my 89th book and have lost count of the number of articles I’ve written in 25 years (in excess of 300, probably closer to 400). I’ve also accomplished technical editing on at least 63 books and achieved all kinds of other tasks associated with technical writing over the years. It has all been interesting. Nothing worth doing is easy though and there have been times where I’ve pulled my hair out trying to discern why something wouldn’t work. Schedules and deadlines have caused me more woe than I care to remember, but I wouldn’t have selected any other career for myself.

There is a secret to my writing and it’s you. My writing has always been about the readerhow to convey the importance of a topic or make the mundane more interesting. Delving deeply into technology is addicting, but I could have done that in other ways and earned a far better living (technical writers are notoriously underpaid, but you knew that already ). Getting an e-mail from someone who has benefited from something I’ve written makes my day special. It fills me with glee to know that you’re better off because I’ve written something that helps. As long as there is an audience who needs my help, I’ll continue writing.

The question I’m asked most often is where I get my ideas from. That’s a hard question because there isn’t a single source of ideas. Some ideas are easythe publisher or a client requests that I write about something. A number of ideas came to me as I was doing something else or even in my sleep. What can I say? I dream about technology. A few ideas were wrought from the forge of deep confusion and consternation as I struggled to achieve seemingly unreachable goals. My wife has inspired me more than once by asking simple questions that would never have occurred to me. Readers provide more than a few ideas and sometimes a book happens because readers have complained about a book that came before. More than a few of my ideas come from experimentsI set something up on my computer, try it out, and see what happens. In this last respect, I get paid to play.

Where do I plan to go from here? Well, I’ll definitely continue to write technical books. Most of my books are about Microsoft products, but I’ve also written about other applications and languages. A few of my books are hardware related and I even wrote a home security book. I’ve written certification guides in the distant past. All of these sorts of books still interest me and I’ll continue to write them. However, an author needs challenges. I’m currently working on ideas for self-sufficiency books. I may eventually write a book of poetry or two. Perhaps I’ll even get into some fiction. Precisely where I end up depends on what sorts of ideas I get and what opportunities present themselves.

This year saw me starting a blog unlike any other blog on the Interneta diverse blog that encompasses everything I do so that you can get to know me as a person. As a reader myself, it’s hard sometimes to imagine what an author is really like simply by reading books that author has written. This blog is meant to bridge that gap for you. I hope that you’ve enjoyed my writings here and in other places over the years. I’m always there when you need me. Here’s to another 25 years. Thank you for your support!

 

Is the Technical Book Dead?

Some time ago I wrote a post asking the question of whether paper books would go the way of the dinosaur (see Paper or e-Book? for details). I recently came across another question, one of whether books will exist at all in the future (at least, technical books). It seems that at least some people now think that online articles (referenced through Google and other search engines) will answer all of their questions and that books are passe. We’ve heard the same death knell sounded before and this one is just as false as those that came before.

There was a time when people said that radio was dead because of television. Fortunately for everyone, the doomsayers were wrong. Radio is still with us—albeit in a different form from those days gone by. In fact, when something proves useful enough, it remains viable and in use despite the appearance of newer technologies. Because of the comments I received from the Paper or eBook? post, I strongly believe that for this reason alone, books will remain one method of choice for obtaining technical information.

Online media does have many good attributes. I have no doubt that it provides a useful and welcome adjunct to books. I use online media myself for some of my research and for general information. From my perspective, online media has the following advantages over books:

 

  • Timely: There isn’t any way a book will ever beat online media to market. Books can’t even beat magazines to market.
  • Succinct: One misconception about online media is that there is no word limit. However, I haven’t ever seen a truly viable book-length online resource. Online resources are broken into small pieces that someone can digest in just a few minutes.
  • Updateable: Both magazines and books have strict limits on updates. If the author makes a mistake, the publisher must provide a separate errata that the reader may not ever find.
  • Inexpensive: There are paid online resources, but they’re in the minority. Most online resources, including this blog, are free. Some online resources do rely on subscriptions and a few are purchased as individual content items (much like a book), but I doubt that paid online media will ever take off as a major industry because it suffers from a severe problempeople tend to post the purchased online media on other sites so that others can download it free (often without any knowledge that the content is pirated).
  • Searchable: Online media has all other forms of communication beat when it comes to searches. You can find what you need quickly, provided that the search engine isn’t overwhelmed with junk listings.


There are probably other reasons for using online media, but these reasons best serve the technical reader. It would seem that these reasons alone would compel a potential reader to use online sources. However, books continue to offer value in other ways. Readers will continue to flock to books (either in paper or e-Book form) for these reasons:

 

  • Accurate: Because books are somewhat permanent, the vast majority are edited by someone other than the author. In fact, most books have several editorseach with a different specialized skill set. Multiple sets of eyes tend to reduce the probability of errors; although, some errors are bound to creep into any form of writing (see my Errors in Writing post for details).
  • Fewer Fads: Books tend to focus on technology that has proven its worth, rather than following every fad on the market. Business runs on proven technology. Someone who is looking for time-tested technology will look in a book, not at an online resource.
  • Author Availability: Having worked through the vagaries of community support myself, I know that it sometimes works, but often doesn’t. A good book author will provide a certain level of support and will answer reasonable questions about book content. You simply don’t get this sort of support using online media.
  • Cohesive: A book offers something that online media can’t in the form of a cohesive work. Whatever the topic is, a book will offer a progression of some type and lets you see a technology from a long view, rather than as snippets.
  • Less Junk: Online media can be clogged with all sorts of junkmaterial that has nothing to do with the topic at hand or that you simply don’t require. Books are more focused, stick to the subject, and are easier to visually filter. As a consequence, you can spend a lot less time getting what you need from a book.


There are some personal issues I have with online media. Many of the books and paper magazines I read are professionally written by authors with the experience to write well. Yes, some online media is also professionally written, but you’re just as likely to run into information written by an unknown entity. Because of the anonymity of the Internet, I find myself checking and rechecking information I obtain from it. Normally, I require at least three different sources, written by different authors, to confirm a fact from the Internet. I’m more likely to accept material from the books of authors that I know well simply because I have read the works of these authors for years and I’ve built up trust in what they have to say. Yes, it’s true that you should verify anything you read, but I find the Internet resources I read are far less reliable.

Much of the confusion about online media has nothing to do with the material itself, but with the authors. When you work mainly with books you hear the voices of a few well-known authors who have helped you over rough spots for many years. The Internet provides a cacophony of many voices that I don’t know. I don’t know how to read between the lines with these authors or understand when I need to consider the author’s personal biases. Again, this is a personal issue, rather than something you’ll need to consider, but if you’re like me, you do need to think about it at least.

I also find that the purpose of online media and books differ. Online media focuses on informing someone of a fact. When you read an online source, it’s to find a bit of information you need now in the fastest manner possible. On the other hand, books tend to focus on teaching. A book presents a topic in a way that helps the reader learn about the technology so that there is a better chance the reader will be able to answer questions about the technology later. This difference in focus is the reason I feel both technologies will remain useful.

As with the radio versus television discussion, I don’t think either online media or books are going to go away. They each have something valuable to offerthey both have their place in your technology toolbox. The ability to choose the right tool, at the right time, has always been the mark of a professional. If you rely exclusively on online media to obtain your technological information, you’re at a distinct disadvantage when compared to the person who uses both online media and books. How do you get your information? Let me know at [email protected].

 

First Snow

FirstSnow

Awoke to white,
what a delight,
the first snow holds us enthralled!

The season’s promise,
is there upon us,
as we prepare for a long winter’s nap.

First comes the fire,
an evening’s desire,
in a woodstove stoked with aromatic wood.

Then comes the cheering,
celebrations endearing,
as friends surround us with glee.

Amidst the swirling,
of flakes now whirling,
I see the ecstasies of days to come.

Copyright 2011, John Paul Mueller

 

Nature at Rest

The job is done,
summer is gone,
nature decides to rest.

Off comes the green garb of work,
displaying raiment of yellow and orange and red,
as nature presides over play.

Deer frolic in woods,
birds flutter in sky,
it’s time for a moment of joy.

As each bows its head,
sleep comes stealthily by,
nature succumbs to the calls of fall.

Winter comes soon,
some think doom,
but nature knows far better.

The promise of spring,
wells up within,
when nature will begin anew.

Copyright 2011, John Paul Mueller

Not Mere Words

A number of readers and editors have asked me about the pains I take in choosing words for my books and articles. Let’s say that it was a revelation that has prompted me to work so hard to create the right word combinations. It came to me one day while I was looking at samples in a paint store. I was looking at paint chips for just the right sort of white. The store must have had twenty or more versions of white—everything from antique white to Arizona white. The winter white intrigued me because it almost looked a bit blue in the store’s light. The idea is that each name is supposed to express the nuance of colorto create a picture in the viewer’s mind.

Many people see words as text. However, text is an abstraction of a wordthe presentation of that word on paper or on screen. Words are expressions of ideas. A word creates a picture of an idea or object in the viewer’s or hearer’s mind. Using the right word transfers an idea precisely from your mind to the mind of someone you want to share an idea with. Consequently, like the paint samples in the store, the nuance of words you choose is important if you want to maintain the clarity of the idea. Winter white isn’t the same as antique white, much as submitting to someone’s authority isn’t the same as acquiescing to someone’s authority. You’ll find both words on the same page in a thesaurus, but they’re different. There is a nuance of difference in the meaning.

There is another important lesson you can learn from paint chips. When you place a winter white chip next to a blue chip, the blue in winter white stands out clearly. However, place the same winter white chip next to a red chip and suddenly winter white looks more white than blue. The context of the paint chip has changed. Likewise, the subtle meaning of a word changes in relation to the words around it. You must consider the context of the word in order to understand its true meaning. In fact, most dictionaries include multiple meanings for a word in order to convey this sense of context.

However, a word is an expression of an idea and not the idea itself. Both the writer and the reader must understand the word in order for the transference of an idea to take place. When the writer and reader have the same understanding of the word, the transference is clear, but it become less clear as the understanding of the two diverge. When a reader doesn’t understand a word, there isn’t any transference at all. Consequently, a well-read author could use terms that a reader doesn’t understand, with the result that reader is confused, not educated or entertained. So, better authors define unusual terms in context, to help readers understand the term and still derive the nuance of meaning the author originally intended.

Technical writing is perhaps one of the more difficult mediums when it comes to word choice. An author needs to convey ideas precisely, which means that a significant range of word choice is both warranted and necessary. However, in order to educate the broadest range of readers, the author is necessarily limited by the need to simplify the text, so as many people as possible can understand it. This dichotomy presents the author with a serious dilemma that editors can sometimes make worse by insisting only on accuracy or only on simplicity, without considering the art behind the writing. (A good editor supplies alternative terms that the author can choose from in order to retain clarity without increasing complexity.) The need to convey ideas clearly in a form the reader can understand is one of the reasons I use beta readers to help refine the content of my books. Beta readers act as a sanity check by helping the author determine which words truly are beyond the average reader’s understanding.

All this leads to a practice that I’ve had since the day of my vision in the paint store. I learn a new word each day. In fact, I use two sources: A.Word.A.Day and Dictionary.com. Both sources send a new word to my e-mail each morning and I choose the word I want to learn that day from them. I may not use all of these words in a book, but the words do expose me to new ideas that will appear at some time in my books. Words are expressions of ideasthe more you learn, the more ideas you possess. What is one of your favorite words? Have you ever found yourself unable to convey an idea because you lack the appropriate word? Let me know at [email protected].

 

Writing a Helpful Review

Reviews are a special kind of opinion, but they’re still an opinion. People often forget this fact as they read a review and accept as factual anything the reviewer has to say. However, even the best review is the opinion of the reviewermaking reviews extremely hard nuts to crack in determining their value to the reader. The best reviews do contain facts and the best reviewers do try to focus their opinion of the product from several perspectives. A good review takes time to write because the author must overcome biases to an extent and try to provide material that will appeal to a larger audience. Good reviews require critical thinkinga type of thinking that’s in short supply in our politically correct society.

Of course, examples of poor reviews abound. John Dvorak recently wrote a post about the potentially corrupt reviews on Amazon (something I’ve suspected for a long time). Short, single paragraph (or sometimes sentence) reviews aren’t all that helpful. Reviews that gush over a product without saying why the product is so great aren’t helpful either. Equally useless are reviews that decry a product as shoddy without explaining what makes it so terrible. In fact, there are few (if any) perfect or completely useless products out therereviews often become a question of balance between the two extremes. Unfortunately, some organizations that request reviews try to artificially balance the review by asking for the three best and three worst features (even when a product lacks sufficient good or bad features to fill the blanks).

So, how do you write a helpful review? First, you begin by actually using the product. If you’re reviewing a movie, watch the entire movie before you start writing anything. Likewise, read the entire book you’re reviewing or test other products in a real world environment, rather than in a lab. In some cases, you see reviews based on the beginning of a movie, a chapter of a book, or the reviewer’s impression after opening the package. Such reviews are useless because they don’t consider the product as a whole.

After you’ve examined the product completely, it’s time to start writing the review. Explore what you feel about the product. Does it work as intended? Is it helpful? Write down your impressions as they come to you. Take time to think about the product critically. Could someone other than you have a use for this product? After all, you already know how you feel about the producta review is meant to help someone else understand the product better, so you’re writing for them, not for yourself.

Verify your impressions by going back to the product. Does the book really contain 101 secrets to making a million dollars by age 10? Is the movie truly presenting a hidden agenda in a candy-coated package? The act of verifying your impressions is important because we all remember things that aren’t actually there. Checking your facts is the mark of a superior reviewer.

Put your impressions into some sort of comprehensible order. Nothing is worse than reading a review composed of seemingly unrelated thoughts. A review should flow in some sort of order. A movie or book often lends itself to a chronological flowfrom beginning to end. However, some reviews work best if you can provide an overview, the good parts, the bad parts, any special features, and then a bottom line that answers the question, “Is this a good product?” or “Why should you buy this product.”

Set the review aside for a day. Go back and read it again. Does the review still ring true? Do you still feel the words you’ve written or have things changed now that you’ve had time to think about the product more? A review is an opinionit’s biased in some respects. However, even with the opinion, even with the bias, a good review still conveys useful information about the product, especially when you back your opinions and biases up with facts.

Not many people want to take the time to write a helpful review. The best reviews require time and skill to write. A helpful review isn’t written in the heat of the moment and it doesn’t lash out at anyone. When you write a good review, it reflects your honest opinion about the product and doesn’t attack the product’s creator. After all, you know about the product, but know nothing about the product’s creator and there is nothing you can tell anyone about the product’s creator, so why go in that direction?

What else would you add to the skills of a good reviewer? Are there any special features you look for in reviews? Let me know at [email protected].

 

Using a Horizontal Web Site Layout

A friend recently wrote to me regarding an issue with Web site layout. Of course, I’ve dealt with Web design issues in a number of my booksmost notably C# Design and Development and Accessibility for Everybody: Understanding the Section 508 Accessibility Requirements. If you look at most Web sites today, they all have three serious problems:

  • The line length is too longforcing the eye to work extra hard to read the material because the eye loses track of the line and actually making it tiresome to review the material.
  • The page contains too much material, which makes it tiresome for anyone working with a screen reader to listen to all the material before finding the one bit of information actually required from the site.
  • The use of vertical scrolling is contrary to the historical use of horizontal scrolling. If you look at how people worked with scrolling in ages past, it was always horizontal, making it easier to read the material.

She even sent me two articles that describe the problem in greater detail. The first article is entitled, “Are Horizontal Website Layouts the Wave of the Future?” and points out that research shows that most people don’t even read the excess material on a Web site. If nothing else, the strong research showing that my efforts are being wasted would tend to make me rethink my design. The second article is entitled, “Horizontalism and Readability” and it places more emphasis on the historical approach to horizontal layout, rather than focus on modern research. I tend to prefer tested approaches to presenting information when I can get them (new ideas are fine for someone else to test).

Of course, a Web site is not the same as printed material. Trying to equate the two could very well be a mistake. Here is my take on how the mediums differ:

  • The method of presentation differs. You’re not relying on paper, you’re using a video screen of some sort and that does make a difference in how the reader perceives the material.
  • The environment differs. I don’t usually sit in my easy chair next to the fire when I read materials online. I’m normally in my office in a formal work environment.
  • The approach to reading differs. My paper reading environment is relaxed and long term. It’s nothing for me to spend an entire day reading a good book. My online reading is more like a sprintI find what I need quickly and never read for more than a half hour at a time.
  • The technology differs. When I read a book, I get print in one size. So, if the print is less than appealing or causes eye fatigue, I’m just stuck with it. My browser allows me to change the font size a Web site uses so I can make the print eye friendly. Although, I would still recommend wearing reading glasses if you find that you’re experiencing eye fatigue from staring at a computer screen, but life should be made easier if you can alter the font size. In fact, I can even use a CSS file to change the typeface and other features for some Web sites.

The obvious question now is whether the two environments differ enough that considerations normally made for paper don’t apply to Web sites. My thought is that creating Web sites with smaller amounts of material, eye friendly design, and shorter columns are all great ideas, but I’m not completely sold on the idea of horizontal scrolling. Of course, every person or business has their preference about how they want their website to look, and that’s fine. That is what makes everyone different. Some may decide to design it themselves, whilst others may decide to enlist the help and expertise of somewhere like Plenty of Pixels – Pasadena Website Design to incorporate everything they want to see on their website. As long as you have all the information you need to attract customers, that’s all that matters. But horizontal scrolling? That’s another story entirely. What is your take on this idea. Let me know at [email protected].