Perfect Love

Perfect love casts out my fear.
Keep your perfect love so near
that I never fear again.
Perfect love for you attain,
‘til my heart with love is filled
and my spirit never chilled.

All around the world I see,
how a perfect love could be,
an answer for mankind’s woes,
when hatred and evil flows,
fueled by fires of doubt and fear,
no one lets the other near.

Open eyes to perfect love,
gift of wonder from above.
A love that gives, never takes,
love that grants others mistakes,
that counts no loss and no gain,
that makes our hearts young again.

Copyright 2012, John Paul Mueller

Is Email Dead?

This is an update of a post that originally appeared on March 4, 2011.

When I originally wrote this post, everyone was proclaiming the death of email, yet here we are 12 years later and I’m still using email to conduct almost all of my business. The original ComputerWorld that I cited describes a company that is moving from email to social media as an exclusive option. However, many current articles like Is email dying as a business communication channel? talk about the demise of email being premature. Currently, I don’t use any of the options mentioned in the ComputerWorld article and don’t have time (or the inclination) to start using them. Don’t get me wrong, social media probably solves problems for some part of the population, it just hasn’t worked out well for me. I can’t see myself outputting tweets about my daily activities and some of the articles I read about Facebook are just plain scary. The company that thinks your right to privacy is irrelevant is facing all sorts of legal problems these days, but it’s entrenched enough that I doubt we’ll see it go away anytime soon.

My main problem with most modern communication solutions is that they’re overly intrusive. I was in the bathroom the other day and a guy was engaging in business while sitting on the commode; he just couldn’t be bothered to turn his cellphone off to take care of personal matters. That’s just one of many scenarios I’d prefer to avoid. There is strong evidence to conclude that our society has become preoccupied with communication, to the detriment of all. Just how many people died last year from texting accidents? According to the The Zebra, texting causes 1.6 billion accidents per year (and the other statistics on the site are even scarier). The National Highway Traffic Safety Administration (NHTSA) logged 3,142 texting-related deaths in 2020. I’m pretty sure I don’t want to talk with someone that badly.

All this said, I did have my first Zoom meeting this year. Except for being able to see the people I was talking with, I just don’t see any reason to use it. Actually, I don’t care what the people I talk to look like as long as they can “lift their end of the log.” Products like Zoom perpetuate bias by promoting impressions based on personal appearance—I consider them dangerous. There is even an issue with the stress and fatigue that using products like Zoom cause as described in On the stress potential of videoconferencing: definition and root causes of Zoom fatigue. All this would be bad enough, but email eliminates issues like people’s accents (given that I’m hard of hearing, accents cause me no end of woe in understanding someone’s conversation). It also provides a paper trail I don’t get with Zoom. So, unless someone is having a serious tantrum, I plan not to revisit Zoom.

I have to admit that in the past 12 years that social media has proven to provide some benefit to business, as described in 22 Benefits of Social Media for Business. As with anything, the disadvantages could outweigh the benefits, as described in 10 disadvantages of social media for business. Here are my personal reasons for choosing email over social media or other options like Zoom:

  • Social media assumes a level of connectivity that I’m simply not willing to allow.
  • Email works better because someone can send me a message and I can handle it later; at my convenience.
  • More importantly, I can handle the email at a time when I’m not distracted by something else.
  • I can provide a thoughtful answer; one that I’ve researched and thought through carefully.
  • Email also provides me with a permanent written record that I can reference later when I have questions about the discussion.
  • Most important to me is that email makes it possible for me to deal with other people without any bias—I don’t care what they look like, what they’re wearing as they type their response to me, where they live, whether they have an accent, or any of a number of other issues that seem to have the world in an uproar today. All I care about is whether they can do the required work.

Personally, I don’t see e-mail as a dead communication technology. If anything, it’s becoming more important to me as I age and my memory becomes less dependable. As far as I’m concerned, the always connected nature of most social media today simply isn’t a good solution if you want to be productive. So, what’s your take on social media? Let me know at [email protected].

Firefly Light

Firefly in the night,
growing dim, shining bright.

Sending messages, in insect code,
come and stay at my abode.

Flying here, flying there,
making art upon the air.

A beam of light, within the dark,
an ember glowing, like a spark.

Hypnotic visions, all aglow,
help me see your jagged flow.

Flights of fancy, are what I see,
as you continue, endlessly.

Until the dawn, grants you rest,
your endless dance, shows your quest.

Copyright 2016, John Paul Mueller

Paper or eBook?

This is an update of a post that originally appeared on February 17, 2011.

When I originally wrote this post 12 years ago, I thought I’d eventually go all digital. For me, there is still nothing better than sitting by my wood stove, coffee cup next to me, reading a favorite work of fiction. Of course, I’m talking about a hard cover or paperback book. Nothing quite matches the feel and smell of paper, especially when you’re reading a book for leisure. The hours I’ve spent reading books have been pleasurable to the extreme. I’m transported to worlds of mystery in some cases, worlds of the future in others. Fantasy, science fiction, techno-thriller; they all hold a certain thrill.

Actually, I have five reading stations in my house, one of which is on my tablet. Yes, I really do read some books now in digital format. Normally, these books are works of fiction that I read somewhere other than home, perhaps at a coffeeshop or restaurant. The easy chair and woodstove with their associated collection of paper books still call to me and I’m thinking now they always will.

It’s a different matter when I start working with technical material. I’ve whittled my collection of technical materials down to a few hundred essential books. Most of the material I read today is online in digital form and I read it at my computer desk so that I have tools like my Integrated Development Environment (IDE) available. In fact, I’d go so far as to say many of the materials I read are in article format, rather than book format now. Still, at this very moment, reading station 3, the dining room table, has a paperback technical book called Microservice Patterns on it. I’m finding it useful for brushing up on my Java as well as learning a few new techniques.

If I need historical information that I know appears in my paper tomes, finding what I need can be hard. Unfortunately, no book cataloging system in the world will solve my problem. I could catalog each of my hundreds of books and still not find the information I actually need with any speed. Of course, the ability search quickly is one of the benefits of digital format. If I had my books in electronic format, I might avoid the hours upon hours of search time for that one piece of information I actually need. Then again, I’ve accidentally found many pieces of useful subsidiary information during such searches, so it’s not possible to discount paper as unworthy. Still, speed is of the essence while I’m working on my next project.

For now, it appears that my future will rely on two media for books: paper for leisure and electronic for work related materials. It’s a sad thing for me to admit, but the paper book has become a bit too cumbersome for a world where search speed is prized above all.

The Owl Said Who

In the middle of the night,
when animals play and fight,
the darkness reigned supreme,
and I heard an owl scream,
Who!

The owl didn’t give a hoot,
or like a crow let out a whoot,
it wasn’t the screech owl’s scream,
but simply, as in a dream,
who.

With the rising of a fog,
I heard the croaking of a frog,
reverberate throughout the wood,
and then the owl, because he could,
said whooo.

As the moon reduced the pall,
It’s glare created shadows tall,
I looked upon the ground below,
for the subject of the low,
when the owl said who?

There he sat upon the limb,
with eyes aglow and visage grim,
his feathers puffed as if to fly,
upon some prey from perch on high,
but all he said was who.

I left him to his thoughts so deep,
of prey afoot that would not keep,
and went to lie upon my bed,
to let sweet dreams fill my head,
and all he said was who!

Copyright 2016, John Paul Mueller

Using Notes, Tips, and Warnings Effectively

This is an update of a post that originally appeared on March 18, 2016.

Writing is all about emotion—I’ve mentioned this need quite a few times in the past. There are many ways to create emotion in technical writing. Of course, word choice, sentence structure, and other tools of the trade come into play, just as they do for every other form of writing. However, one of the approaches that is truly different in technical writing is the use of notes, tips, and warnings. In all three cases, you create a single paragraph sidebar-like structure, but the emphasis and nuance of the inclusion is different from other sorts of writing:

  • Notes: Information that you want to include as an aside to the main text. You might choose to document the information source, the location of additional information, or augment parts of the main text in some way. The emotional impact of a note is the feeling of being special. When the reader sees a note, it should evoke a feeling that this is peculiar or extraordinary information that could impact the reader’s use of technology.
  • Tips: Information that is extra in nature. You might choose to include a personal technique that you haven’t seen documented anywhere else, the location of goodies that won’t necessarily affect the reader’s use of technology described in the book, but will add to the readers appreciation of that technology, or some sort of gift-like source, perhaps a free download. The emotional impact of a tip is one of surprise. When a reader sees a tip, it should evoke a sense of getting extra value from the book—something unexpected that adds value to the reading experience. A reader should get the tingly feeling that one gets when receiving an unexpected present.
  • Warnings: Information that is dire in nature. Reserve warnings for those times when a reader’s incorrect action could cause personal, data, or other sorts of damage. The emotional impact of the warning is dread. The reader should see a warning as a notification that incorrect actions are rewarded negatively—they’re the stick that goes with the carrot of notes and tips.

It’s important to remember that these three constructs aren’t the main event. Your body text is still the main event and these three elements serve only to emphasize that material in some way. Depending on the book you write, you may have other specialized paragraphs at your disposal. Each of these unique paragraph types should evoke a particular emotion. Unfortunately, the emotion they should evoke is seldom documented, so you need to figure it out for yourself. It’s essential that you do take the time to discover what emotion the paragraph is supposed to evoke (or simply not use the special paragraph in your writing).

Keep notes of what you do and why you do it. When working with various kinds of special writing, you want to be sure that the emotions you evoke with unique paragraph types is consistent across your various publications, especially if those publications are all from the same publisher. Create a style guide of a sort for yourself that contains these notes to yourself so that you can find them easily. Organizing your style guide for easy access is also a plus (which means your style guide should appear in digital, rather than paper, format.

Unlike sidebars, notes, tips, and warnings are rarely more than a paragraph long. You could possibly make an argument for two paragraphs in rare circumstances. The paragraph should contain two or three sentences with the first sentence providing a summary and the second providing details. A third sentence provides ancillary information as needed. The structure and content of your special paragraph should reflect the kind of paragraph you’re creating—as with a good actor, keep your paragraph in character. After all, it’s a performer on the stage of your book and presents the reader with a special feature that is unavailable elsewhere.

Using the special paragraphs at your disposal in the correct way can mean the difference between communicating effectively with your reader and losing the reader’s attention completely. Let me know your thoughts about the use of notes, tips, warnings, and other special paragraphs at [email protected].

Supporting Creative People

This is an update of a post that originally appeared on March 28, 2016.

Authors get tired of hearing from the Information Wants To Be Free (IWTBF) crowd who thinks it’s terrible that they charge for their books. Somehow, authors and other creative people are supposed to exist by taking sustenance from the air. There is an interesting discussion of the topic at Should Information Be Free? in which the author says the information should be free from the perspective of everyone getting to use it, but that the people who write and print books should still get paid. Obviously, if I didn’t want to freely share information with others, I wouldn’t have created this blog and not charged for it. The point is, when someone steals Intellectual Property (IP), the person who created it isn’t being supported.

I work really hard to support my readers and so do many other authors. In fact, most creative people are in creative trades because they like to communicate with others using a variety of methods. The simplest goal is to provide something of intangible value to others—be it a painting, sculpture, dance, music, or writing. It’s well known that creative people are often underpaid (hence the cliché, starving artist). Because the starving artist (and most of them truly are starving) makes little money, it’s important that people do support them whenever possible. That’s why the piracy of IP is such a problem. IP theft has become a serious enough problem that we’re beginning to lose many good creative people simply because they no longer have enough money coming in to make a living.

The problem is that many people would support the creative people whose IP they use, but they don’t really understand that they need to pay for this material. For example, there are many sites online now that offer my books free of charge. Just viewing the site doesn’t provide a clue that anyone is stealing anything. These sites have a clean appearance and simply offer IP in the form of downloadable music, books, and so on. In fact, many of these sites are fully searchable. The reasons that someone would do something like this varies, but it pays to employ some critical thinking when you see something free that possibly looks a bit too good to be true. Many people download viruses, spyware, and other sorts of malware along with their free download. In the long run, it’s actually less expensive to buy the IP, than to have a computer compromised by some of the crud that comes with these free downloads.

For the record, my books are never free. You need to pay for your copy of my book in order to support the various things of value that I provide to you as a reader, including this free blog. It isn’t my goal to become rich—if that were my goal, I’d be in some other line of work (believe me when I say authors aren’t paid particularly well), but I do need to make enough to pay my expenses, just as you do. Even though I know many people do download my books free, I still support everyone that I can with good advice on how to get the most from the books I write. To me, coming in each day and working with all of you is one of the benefits of being an author. I truly do want people to use my books to get ahead in life. If you’d like to discuss the effects of piracy on you as a consumer of IP, please write me at [email protected].

Using TinyURL in Books

At one point in my career I avoided the use of URL shortening sources because readers complained that they couldn’t be sure where the URL would take them. For example, a TinyURL URL has the tinyurl.com host in it. The TinyURL for my blog is https://tinyurl.com/2p9xw5u7. The article, Secure Options for URL Shortening, discusses the whole matter of URL shortening security in more detail, but at least some organizations still don’t trust the process.

The problem I’m encountering as both a writer and a reader is that URLs, especially technical URLs, are getting progressively longer. I’m reading one book right now where some URLs are spreading over multiple lines in the text and typing them by hand is a nightmare. Some of my readers are starting to complain to me as well. They don’t want to type a URL that extends over multiple lines in the book, so they’re not looking at that really cool resource I found that explains some technical detail in a manner that I can’t really include in the book due to space limitations.

The way around the URL shortening problem is to use a site like TinyURL that has a trick you can apply to verify where a URL goes. In this case, you simply add the word preview to the URL like this: https://preview.tinyurl.com/2p9xw5u7. Now you can see where the URL goes before you go there, making the use of TinyURL significantly safer.

What I need to know before I start adopting TinyURL in my books for all URLs is whether this would produce major discontent among my readers or you would welcome the change with relief. Personally, I think the use of TinyURL will spare everyone a lot of frustration. However, I need to know what you think. Please write with your thoughts and concerns to [email protected].

Apathy, Sympathy, and Empathy in Books

This is an update of a post that originally appeared on May 23, 2016.

I’ve written more than a few times about the role that emotion plays in books, even technical books. Technical books such as Accessibility for Everybody: Understanding the Section 508 Accessibility Requirements and Machine Learning Security Principles are tough to write because they’re packed with emotion. The author not only must convey emotion and evoke emotions in the reader, but explore the emotion behind the writing. In this case, the author’s emotions may actually cause problems with the book content. The writing is tiring because the author experiences emotions in the creation of the text. The roller-coaster of emotions tends to take a toll. Three common emotions that authors experience in the writing of a book and that authors convey to the reader as part of communicating the content are apathy, sympathy, and empathy. These three emotions can play a significant role in the suitability of the book’s content in helping readers discover something new about the people they support, themselves, and even the author.

It’s a mistake to feel apathy toward any technical topic. Writers need to consider the ramifications of the content and how it affects both the reader and the people that the reader serve. For example, during the writing of Artificial Intelligence for Dummies, 2nd Edition, Python for Data Science for Dummies, and Machine Learning for Dummies, 2nd Edition Luca and I discussed the potential issues that automation creates for the people who use it and those who are replaced by it in the job market. Considering how to approach automation in an ethical manner is essential to creating a positive view of the technology that helps people use it for good. Even though apathy is often associated with no emotion at all, people are emotional creatures and apathy often results in an arrogant or narcissistic attitude. Not caring about a topic isn’t an option.

I once worked with an amazing technical editor who told me more than a few times that people don’t want my sympathy. When you look at sympathy in the dictionary, the result of having sympathy toward someone would seem positive, but after more than a few exercises to demonstrate the effects of sympathy on stakeholders with disabilities, I concluded that the technical editor was correct—no one wanted my sympathy. The reason is simple when you think about it. The connotation of sympathy is that you’re on the outside looking in and feel pity for the person struggling to complete a task. Sympathy makes the person who engages in it feel better, but does nothing for the intended recipient except make them feel worse. However, sympathy is still better than apathy because at least you have focused your attention on the person who benefits from the result of your writing efforts.

Empathy is often introduced as a synonym of sympathy, but the connotation and effects of empathy are far different from sympathy. When you feel empathy and convey that emotion in your writing, you are on the inside, with the person you’re writing for, looking out. Putting yourself in the position of the people you want to help is potentially the hardest thing you can do and certainly the most tiring. However, it also does the most good.

Empathy helps you understand that someone who loses a job to automation isn’t looking for a new career, the old one worked just fine. The future doesn’t look bright at all to them. Likewise, some with disabilities isn’t looking for a handout and they don’t want you to perform the task for them. They may, in fact, not feel as if they have a disability at all. It was the realization that using technology to create a level playing field so that the people I wanted to help could help themselves and feel empowered by their actions that opened new vistas for me. The experience has colored every book I’ve written since the first time I came to realize that empathy is the correct emotion to convey and my books all try to convey emotion in a manner that empowers, rather than saps, the strength the my reader and the people my reader serves.

Obviously, a good author has more than three emotions. In fact, the toolbox of emotions that an author carries are nearly limitless and its wise to employ them all as needed. However, these three emotions have a particular role to play and are often misunderstood by authors. Let me know your thoughts on these three emotions or about emotions in general at [email protected].

Handling Source Code in Books

This is an update of a post that originally appeared on April 4, 2011.

One of the biggest conundrums for the technical writer is how to handle source code in a book. The goal is to present an easily understood example to the reader—one that demonstrates a principle in a clear and concise manner. In fact, complexity is a problem with many examples—the author tries to stuff too much information into the example and ends up obfuscating the very principles that the reader is supposed to obtain.

There is also the problem with pages because books have a limited number of them. The technical writer must balance the depth and functionality of the examples against a need to present as many examples as possible. Even if a book is balanced, some readers are going to be disappointed that the book doesn’t contain the example they actually needed. So, very often simplicity must win the day in creating application source code for a book, despite the desire of the author to present something more real world, something with additional glitz and polish.

Because the goal of an example is to teach, very often the examples you see in a book have more comments than those that you see in real life. An example in a book must include as much information as possible if the code is going to fulfill its purpose. Of course, book comments should illustrate all the best principles of creating comments in real code. In short, if real world code looked a bit more like book code, then its possible that developers would spend far less time trying to figure code out and more time making changes.

Some readers will take the author to task because the code may not always provide the error trapping that production code provides. In fact, as with many teaching environments, the safety features in code are often removed for the sake of clarity. This problem plagues other environments too. In the past, it was common for woodworking magazines post a note near the beginning of the magazine telling the reader that the safety devices have been removed for the sake of clarity and that no one in their right mind would actually work with woodworking equipment without the safety devices. Likewise, the code you see in a book often lacks sufficient error trapping, making the principle that the code demonstrates clearer, at the cost of fragility. You can usually cause book examples to break easily, but no one in their right mind would create production code like that.

Choosing good examples for a book is hard, so getting your input really is important. I may not be able to provide precisely the example you need or want, but I may be able to provide something similar in the next edition of the book. Of course, I won’t know your needs or wants unless you tell me about them. I’m always open to hearing your ideas. However, I’m not open to providing free consulting in the form of troubleshooting your error code unless you’re willing to hire me to do so. Please keep the discussion to ideas that you’d like to see in book updates by contacting me at [email protected].