Category: Technical

The Effects of Using Terminology Incorrectly

I read an interesting article the other day by Lorinda Brandon entitled, “When Buzzwords and Jargon Backfire.” The actual article is about the relevance of terms when applied to APIs. However, in a larger sense, the author of the article is spot on in decrying a situation that has continued to occur as long as I’ve been writing (quite a while). People who are involved in an industry, but don’t necessarily understand it completely, misapply terminology related to that industry in a way that causes the terms to lose meaning and focus. In this particular case, the author begs people using certain terminology to explain precisely what they mean and how the resulting infrastructure will benefit the people using it. This is a valid request and one I hope the article’s readers will respect.

However, the article brings to mind far more serious misuses of terminology. Many people still don’t understand the difference between a hacker (someone who understands and uses technology at a low level to perform useful and usually positive tasks) and a cracker (someone who uses technology, not necessarily at a low level, to break into systems and cause other forms of mischief). As an author who really does care about the misuse of terminology, I often try to explain the difference, but as someone astutely pointed out, I’m probably bailing a sinking boat that has a rather large hole in the bottom. In some cases, the terminology is used incorrectly for so long that it acquires a new meaning. Of course, languages change as does every other living thing, so growth in the form of existing words with new meanings and the addition of entirely new words is both expected and encouraged. Someday I may actually give up trying to distinguish between hacker and cracker (but it won’t be today).

However, misusing technical terms doesn’t simply affect the growth of our language. Unfortunately, misusing terms can lead to all sorts of negative consequences—some dire. Imagine that someone has made claims for a particular technology and misused terminology to do so. You may obtain the technology with certain expectations based on the precise definition of the terminology, but only later find that the technology doesn’t address the need at all. What if that technology is used in the health care industry or as part of heavy construction? The misuse of terminology through ignorance or (worse yet) to sell product isn’t acceptable. In most cases, materials written by less skilled authors should be vetted by those who have a firm grasp of the required terminology before the material is released to the public to avoid misinterpretation. It’s a simple, yet effective, means of retaining the meaning of special words.

When writing documents of any sort, keeping a dictionary close at hand and consulting with others who understand terminology at a precise level is always a good idea. It may surprise you to know that I still use these two techniques to ensure my writing is as accurate as possible. I don’t always succeed and you can be certain that some readers will take me to task for my mistakes. Unlike many authors, I do try to clear up these misunderstandings through my blog posts (which I hope that you read). What terminology do you find most confusing? Which terms do you wish others would use with greater precision? Let me know at [email protected].

 

Get Ready…Get Set…Garden! 2013

This year’s trip to Baraboo for Get Ready…Get Set…Garden! is part of our continuing education. I talked about this particular educational opportunity in last year’s Get Ready…Get Set…Garden! post. The sessions are hosted by the Sauk County UW Extension, which actually puts on a substantial number of events during the year. Our itinerary for this year consisted of container bag gardening techniques, growing small fruits (strawberries, raspberries, and blueberries), and gardening with aches and pains (essentially a session on dealing with accessibility needs for gardeners).

The first session discussed container bag gardening and the advantages it offers over using buckets or over-sized pots to hold your garden on the patio. Every year Rebecca puts together a wonderful salad garden for me. Of special interest are the cherry and salad tomatoes. If I need a snack, I simply go outside, enjoy the flower garden she has put together for me, and munch a few tomatoes-nothing could be better than that. However, we had always wondered whether there might be something more that we could do. This year’s sessions shows that we can. However, instead of using the really expensive gardening bags that the instructor promoted as part of her business, we plan to use feed sacks. They’ll perform the same function and only cost a fraction of the amount (a bag large enough to grow tomatoes costs $22.00 if you go the garden bag route, the same size feed bag is free since we get them as part of buying feed for our animals). I’ll post again sometime later this year to let you know how the garden bags work.

We have also had a lot of problems growing blueberries, despite ensuring the ground is acid enough for them. It turns out that we have been doing a few things wrong-the most important of which is that we haven’t been watering our blueberries enough. It seems that they require almost boggy conditions to grow acceptably. Equipped with our new knowledge, we’re going to give blueberries another try this summer. One of the problems with gardening is that you aren’t likely to get the technique right on the first try, or the second, or the third. There are some people who think gardening is science. Well, that’s partially correct, but it’s also part art. Sometimes you just need to feel your way through a growing experience. The garden is looking great at the minute and I’m currently looking at storage buildings in PA as I need somewhere to store my tools and to put my feet up at the end of a rough day! I’m thinking of putting the building next to my allotment so that it’s looking out onto a nice view. I’m not 100% sure yet though!

Unfortunately, our instructor didn’t arrive for the third session. Someone with the UW Extension did fill in, but I can’t help but feel a bit disappointed because I was really looking forward to getting quite a lot out of this third class. As Rebecca and I get older, it would be nice to know about a few of the things we could do to make our gardening experience better. Even so, I must applaud the UW Extension instructor for getting up and giving an impromptu discussion on a topic that she hadn’t prepared for without any preparation time. To simply get up and start talking would be one thing-to do it exceptionally well given the circumstances is nothing short of amazing. I also plan to post again on some thoughts I garnered on meeting accessibility requirements for gardening.

There are some benighted people who think that education ends when you leave high school or college. Education is a lifelong endeavor. Gaining new knowledge and then turning it into wisdom adds spice and keeps our minds fit. Whether your intellectual love is technical, natural, or in some other realm, take time to embrace it by furthering your education. Let me know your thoughts on continuing education at [email protected].

 

E-book Integration in Schools

I use every opportunity I can to track the change in how people read information. Some of this material is in articles, some comes from readers and friends, and some comes from just observing. For example, at one time people would grab a magazine from the rack at our doctor’s office. Now it’s quite likely that they’ll take out a Kindle or other reading device to view their favorite novel. Even at our library, I see people sitting in front of computers reading, rather than holding a book. Increasingly, I get questions from readers who use the e-book version of my books, instead of paper copies. Let’s just say that in the year and two months since I wrote The e-Book in Your Future, things have changed considerably. E-books are reducing the cost of reading material of every sort, especially technical books.

That’s the reason I’m a bit concerned about some of the things I read about our school system, especially when conversations with students tend to bear out the information I read. One ComputerWorld article in particular, “The e-book revolution is bypassing U.S. elementary schools” really grabbed my attention. The author, Joe Mohen, makes some astute comments about the benefits of using e-books in schools. As an author, I see significant benefits in using e-books, such as the ability to update the information as needed. Schools often struggle with outdated texts now due to a lack of funds, using e-books greatly reduces the cost of updates making it possible for schools to keep their texts updated.

More worrisome is the fact that most of our colleges still use paper texts. In talking with any number of students, I have yet to find any of them using more than one or two e-books for their classes. Given the high cost of education, it makes sense to reduce costs by providing students with materials in electronic format. A recent Forbes article, “Should College Students Be Forced To Buy E-Books?” makes a strong case for using e-books in colleges. The same article points out that only three percent of students currently use e-books for their education.

My interest in e-book technology isn’t just a passing fancy. Part of the reason I spend so much time delving into this issue is to discover how to serve you best. A large percentage of my readers are college students. What if my books were offered only in e-book format? Would you still buy them? For now, my books will continue to appear in both print and e-book format for the most part, but the time could come when I’m asked about how my readers would be affected if the publisher produced only e-books. To answer that question, I need your input. Let me know your thoughts about e-books, especially in the school environment, at [email protected].

 

Continuing Development of Accessibility Aids

Technology continues to improve in its support for those with special needs. I try to read as many articles as I can on the subject because I truly believe that computers offer the means to provide a level playing surface for everyone. I’ve posted a number of other times about improvements in technology that will eventually help people lead better lives, even when they have special requirements. As our population continues to age, this technology will also help older people in the population to continue making valuable contributions to society as a whole, so these technologies aren’t just for the few—everyone is affected at some point.

I read with interest a story about new bionic hand. The problem with any prosthetic limb is that it doesn’t provide feedback. Without touch, using a prosthetic is incredibly hard. You must be able to feel what is happening at the end of your arm. This new bionic hand does just that—it provides some level of feedback using the person’s own nervous system. I find this amazing because it would have been science fiction just a few years ago. I had previously written about the ability of someone to simply think about the motion required to perform a task in The Bionic Person, One Step Closer, but this is different. Not only can the person think about what to do, but they can also feel the activity when they do it. Of course, it isn’t anywhere near as useful as a real hand, but technology takes small steps forward.

This new hand isn’t permanent yet, nor are any of the other exciting technologies in the works right now. The biggest problem is that the electrodes used to communicate with the brain cause problems—essentially, the body rejects them. In addition, the prosthetic limbs have a long way to go before they become as usable as natural limbs. For example, a natural hand has 22 degrees of controls, while the best that a prosthetic limb can manage is seven.

Many of the technologies used to help people with visual problems have been temporary as well. However, a new bionic eye may change that. In this case, the eye is designed to help someone with a specific eye disease and they must still wear special glasses to make the modifications work. However, the eye implant is permanent in this case, which means that after surgery a person has a permanent change in their vision that they can count on using.

This truly is an exciting time because it’s slowly becoming possible to give people their lives back when something catastrophic happens. Many of the articles that I’ve read say that it will still take 20 or 30 years before science has developed limbs and other body parts that function as well as the real thing, but every advance made does help at least a little. What are your thoughts on the bionic person? Let me know at [email protected].

 

Changes to the Start Command Functionality

Sometimes a change command line command occurs and no one really notices for a while, except that there is some oddity in the way the command executes. This is how I recently figured out a change to the Start command. Some update Microsoft provided changed the way it worked, but I have no idea of which one.

I have a batch file in the Startup folder that automatically loads all the sites I use in my favorite browser when I start my system in the morning. The old command looked like this:

Start "C:\Program Files (x86)\Mozilla Firefox\Firefox" "http://antwrp.gsfc.nasa.gov/apod/"

This command starts a copy of Firefox and loads Astronomy Picture of the Day (APOD) for me. The interesting thing is that the command continued to work, despite the change in the Start command functionality. What changed was the fact that the command window didn’t go away once the sites were all loaded. The command window would remain in place until I closed the browser. I’ve had a lot of other things to worry about, so all I did was minimize the command window and let it disappear after I had looked over my sites in the morning.

Notice how the command is in quotes. This is a necessity because there are spaces in the command, so it won’t execute if you don’t place it in quotes. After some investigation, it turns out that the new behavior is treating the command as the Title argument for Start, rather than as the command. The Start command was opening the site based on the URL argument alone. Just why the command window wasn’t closing is something I haven’t figured out yet.

Recently I decided it was time to work out the problems with the Start command because I wanted to use Chrome to load some sites (in addition to those loaded by Firefox) and Chrome wasn’t loading them. The sites were all loading in Firefox. So, I wandered over to TechNet to see what Microsoft has to say on the Start command and that’s when I noticed that the documentation had been updated on April 17, 2012—about the time I started experiencing my little problem (it does sometimes take forever for me to get the time needed to fix an issue).

After thinking through the command for a little while and trying a few alternatives at the command line, I finally came up with a new command for the batch file. Here is the result:

Start /D"C:\Program Files (x86)\Mozilla Firefox\" Firefox.exe "http://antwrp.gsfc.nasa.gov/apod/"

The new version of the command uses the /D command line switch to specify the path to the command. There is nothing new about the /D command line switch—you simply didn’t need to use it in the past to get the desired result from the Start command. Notice that the command now includes the full executable name and extension. The argument appears after the command as before. Now the command executes properly and the command window closes after all the sites are loaded.

Make sure you use this new information when working with either Administering Windows Server 2008 Server Core and Windows Command-Line Administration Instant Reference to ensure you get the desired results from the examples. Also let me know about any issues you encounter with commands in either book at [email protected].

 

The Myth of the Unbreakable Password

Complete books have been written about the topic of security and the correct way to create passwords. Each expert claims that if you only adhere to the conventions that he or she sets forth, that your computer will be safe. Let me say up front that the unbreakable password is a myth. Yes, you need to come up with something a lot better than “Secret” or your birthday, but be assured that any password you use is breakable. In fact, in the real world, what you’re striving to do is create a password that takes longer to break—realizing that anyone who really wants access to your system will gain it. Computer hardware has become so powerful that seemingly unbreakable cryptography is quite vulnerable today.

Many security experts want you to use completely undecipherable passwords such as @f*/L12-X]. If you can’t come up with a good password of your own, PCTools actually provides a generator to create one for you. If you’re unsure about the safety of your password, you can have it checked to determine how long it would take to crack. (Unfortunately, the number you get isn’t completely realistic because computer technology for cracking passwords improves all the time, as does the capability of the hardware used to crack it.) Of course, it would be absolutely impossible to remember such a password, so anyone having such a password is going to write it down. All someone has to do is pose as a janitor and pick up all the yellow stickies that have the password printed on them (or write them down as they pass through to avoid suspicion). For that matter, social engineering attacks can often yield passwords through a phone call in a few minutes.

Because truly secure passwords are the stuff of science fiction, other experts have come up with the passphrase. A passphrase such as “My yellow car is gr8!” theoretically has a long crack time and are easy to remember. Unfortunately, recent advances in cracking technology seem to make passphrases a bad bet too. It seems that the crackers now use grammar as part of their strategy to figure out your password. They use applications to figure out the most common words that would come in a sequence of words.

The advice today is to use unrelated words separated by special characters—something I have advocated in any book I write that contains information about security. A password like “Elephant*Green?H3llo” is infinitely easier to remember than @f*/L12-X], but still quite secure. Even so, if someone is determined, they can combine a dictionary attack with some brute force techniques and discover your password in a reasonable amount of time—assuming you don’t simply give it to them as part of a social engineering attack.

There are technologies that promise to make it harder for crackers to gain entry to a system, but they’re usually complicated. For example, you can add a retina (iris) scanner or thumbprint reader to improve security, but that means an additional purchase, specialized software, training, and other costly changes to your setup. Security cards are another option, but again, you have additional costs to consider and the use of a security card is open to social engineering attacks (unlike a person’s thumb or retina, which are firmly attached). Most organizations still rely on passwords or passphrases in the interest of saving money, so creating usable, easily remembered passwords that truly are safe should be the focus of administrators whenever possible.

One new method of securing systems does appear in Windows 8. In this case, the system displays a picture when you start it up and you use gestures to circle or otherwise identify pictorial elements in place of typing a password. There are some experts who are already saying the feature is easily cracked. It seems as if the technique would be unwieldy with a mouse and it has already been said that most people aren’t buying touch screens to use with Windows 8 (see my Some Interesting Windows 8 Information post for details), so this security feature may be a non-starter for most organizations.

Passwords and passphrases won’t likely go away soon, so the best approach for most users and administrators is to create a system where passwords are complex, easily remembered (and therefore, not written down), and changed relatively often. The combination of these three elements should make your PC safer from crackers. However, the best security is vigilance. Check your system for intrusion often. Rest assured, someone who really wants to get in will do so and without too much effort. Let me know your thoughts about passwords at [email protected].

 

Creating Links Between File Extensions and Batch Files

A couple of weeks ago I wrote a post entitled, “Adding Batch Files to the Windows Explorer New Context Menu” that describes how to create an entry on the New context menu for batch files. It’s a helpful way to create new batch files when you work with them regularly, as I do. Readers of both Administering Windows Server 2008 Server Core and Windows Command-Line Administration Instant Reference need this sort of information to work with batch files effectively. It wasn’t long afterward that a reader asked me about creating links between file extensions and batch files. For example, it might be necessary to use a batch file to launch certain applications that require more information than double clicking can provide.

This example is going to be extremely simple, but the principle that it demonstrates will work for every sort of file extension that you can think about. Fortunately, you don’t even need to use the Registry Editor (RegEdit) to make this change as you did when modifying the New menu. The example uses this simple batch file named ViewIt.BAT.

@Echo Processing %1
@Type %1 | More
@Pause

Notice that the batch file contains a %1 entry that accepts the filename and path the Windows sends to it. You only receive this single piece of information from Windows, but that should be enough for many situations. All you need to do then is create a reasonably smart batch file to perform whatever processing is necessary before interacting with the file. This batch file will interact with text (.TXT extension) files. However, the same steps work with any other file extension. In addition, this isn’t a one-time assignment—you can assign as many batch files as desired to a single file extension. Use these steps to make the assignment (I’m assuming you have already created the batch file).

  1. Right-click any text file in Windows Explorer and choose Open With from the context menu.
  2. Click Choose Default Program from the list of options. You see the Open With dialog box shown here.
    Link01
  3. Clear the Always Use the Select Program to Open this Kind of File option.
  4. Click Browse. You see the Open With dialog box.
  5. Locate and highlight the batch file you want to use to interact with the text file (or any other file for that matter) and click Open. You see the batch file added to the Open With dialog box.
  6. Click OK. You see the batch file executed on the selected file as shown here.
    Link02

At this point, you can right-click any file that has the appropriate extension and choose the batch file from the Open With menu. The batch file will receive the full path to the file as shown in this example. It can use the information as needed to configure the environment and perform other tasks, including user interaction. Let me know your thoughts on linking file extensions to batch files at [email protected].

 

Sending Comments and Asking Questions

Anyone who reads my blog for very long understands that supporting my books is a big deal for me. I actively work with my readers because I realize that you have the choice of using books written by other authors. Let’s just say that my support system is one of the reasons you really do want to buy my books. My blog not only answers common questions you have, but also adds examples and other information to the information you already receive through my books, so make sure you keep you eyes peeled for additional information here as well.

The last time I discussed this topic was in 2011 in my Contact Me, Please! post. The same things apply now as they did then. I’ll answer your book-specific questions as soon as I possibly can and in as much detail as I can. However, I won’t write your school term paper for you, accept a marriage proposal, or provide free consulting (amongst other things readers have asked me to do in the past). If you’re having problems with an example or can’t find the book’s source code, please be sure to ask because I want your experience with my books to be nothing less than phenomenal.

I also encourage you to be a beta reader. You can see the posts I’ve made for several recent books. The biggest reason for me to ask readers to participate in the book building process is to ensure you get the book you want. I also want to avoid Errors in Writing. As far as I know, I’m the only technical author on the planet that invites reader comment during the writing process, but I truly feel your input is essential, so I request it in every way I can. As I get new book contracts, you’ll continue to see requests for beta readers posted on my blog.

You can always contact me at [email protected] with any comments and questions you have. This includes both books and blog posts. Let me know about any concerns you might have and I’ll do my best to solve them. In the meantime, happy reading !

 

Adding Batch Files to the Windows Explorer New Context Menu

Administrators are always looking for ways to perform tasks faster. Most administrators have little time to spare, so I don’t blame them for looking for new techniques. One of the ways in which administrators gain a little extra time is to automate tasks using batch files. Both Administering Windows Server 2008 Server Core and Windows Command-Line Administration Instant Reference provide significant information about creating and using batch files to make tasks simpler. However, a number of readers have asked how to make creating the batch files faster by adding batch files to the Windows Explorer New context menu. That’s the menu that appears when you right click in Windows Explorer. It contains items such as .TXT files by default, but not .BAT (batch) files.

Being able to right click anywhere you’re working and creating a batch file would be helpful. Actually, the technique in this post will work for any sort of file you want to add to that menu, not just batch files, but the steps are specific to batch files.

 

  1. Open the Registry editor by typing RegEdit in the Search Programs and Files field of the Start Menu and clicking on the RegEdit entry at the top of the list.
  2. Right click the HKEY_CLASSES_ROOT\.bat key and choose New | Key from the context menu. You’ll see a new key added to the left pane.
  3. Type ShellNew and press Enter.
  4. Right click the new ShellNew key and choose New | String Value from the context menu. You’ll see a new string value added to the right pane.
  5. Type NullFile and press Enter. Your Registry Editor display should look like the one shown here.
    NewBatchFile01

At this point, you should be able to access the new entry in Windows Explorer. Right click anywhere in Windows Explorer and choose the New context menu. You should see the Windows Batch File entry shown here:

NewBatchFile02

Selecting this entry will create a blank batch file for you in the location you selected. All you need to do is open the file and begin editing it. What other sorts of time saving methods do you find helpful in working with batch files? Let me know at [email protected].

 

Too Much Detail

A trend has started in publishing of all sorts and it affects technical writing most of all. A friend of mine recently wrote a piece entitled, “A Multimedia Avalanche.” The post spoke to me on many different levels. As an author, it spoke to me of the need to keep my pieces short and to the point. No one wants to read every detail about every event that has ever happened—it simply isn’t possible to absorb more than the “Reader’s Digest” version of many of the events that take place in our lives. It makes me think of the supposed Sergeant Friday (Dragnet) quote, “Just the facts, ma’am.” The problem with using a medium such as the Internet is that people tend to think in terms of unlimited space, rather than limited reader attention. As an author, it’s important to write concisely, yet clearly.

As a reader, it spoke to my desire to throttle some authors to within an inch of their lives. After wasting my time, they never do seem to get to the point. An editor of mine is famous for pointing to the need to state the purpose of an article within the first paragraph and then to keep the article focused on that purpose. It’s good writing practice to write the beginning and ending of the article first, and then write the material needed to fill in the details. It’s a simple trick to keep the article short and focused.

As a citizen, the article spoke to the need to keep the media in check. No, the government shouldn’t perform this task; the reader should. When the media hypes a story all out of proportion, it brings out the mob mentality of some people. Suddenly, the government finds itself swamped with calls for needless changes for a non-event that was sensationalized by someone who wasn’t thinking. These sorts of issues tend to waste considerable funds that could be better used for other purposes (such as saving the taxpayer from an increase in taxes).

Information overload, wasted money, wasted time, and other such problems will only increase as citizen journalists and others with way too much time on their hands contribute toward an increasing array of articles that bury the reader in detail. To quote my friend’s article, “just because you can do something doesn’t always mean you should.” It’s good advice.

What is your take on too much detail, especially as it relates to technical writing? Let me know your thoughts at [email protected].