Archive

Tag Archives: writing

JudyS

Joyful Judy!

Owning a technical writing business for 30 plus years has been a true joy. While researching, writing, and publishing all sorts of publications for clients, I have enhanced my own authoring and publishing skills, which now include creating my own books, all of which are labors of love. Recently, I updated my Amazon author page. Very recently, I converted my newest book, Living Well in Froggy’s World of Plenty: Sweet Talk to Read Aloud into an ebook.

My next steps include:

I hope you will take a look and have a joyous moment.

Advertisement

books-2270835_640

Over many years, all of us at Shenouda Associates Inc. have researched, written, edited, and published hundreds (maybe even more) of works both large and small. For us, attention to detail is more than chic or fashionable. It is de rigueur—necessary, required, and proper. Shenouda team member, Donna Muldoon, knows a thing or two about guides to stylish writing. Here is her take on the subject.

Of all the tools that a writer employs, a style guide may be the most used, most reliable, and most important in the day-to-day work of that writer. A style guide that is well organized, complete, and easy to use can save a writer the time and frustration of continually looking up information.

Just as an encyclopedia is a reference source that provides information that can be found in several other sources, a style guide can also act as a compendium of much of the information needed by a writer. A style guide is part Bible, part cookbook, part dictionary, part game rule book, and part fashion magazine. Like the Bible, a style guide proclaims what you shall and shall not do. As a cookbook, it outlines the recipes for font, color, dimensions, and icon usage. It serves as a shortcut dictionary for both common and product-specific words. Like a game rule book, a style guide can make referee-type decisions by reinforcing legal and corporate standards in matters of dispute. And the fashion magazine aspect is characterized through guidelines on tone, voice, and the presentation of content.

The main purpose of a style guide is to provide uniform, consistent standards throughout a group—whether it is a company, a field, a community, or a publication. The standards can form a unified voice and appearance that create a single brand image for all content creation including web pages, video, and marketing collateral. But most importantly, it ensures that multiple writers, contributors, and editors write with a common consistency.

So many options

There are several well-known commercial style guides such as the Associated Press (AP) Stylebook, The Chicago Manual of Style, and the newly updated Microsoft Writing Style Guide. These are acknowledged sources of editorial guidance used and approved by various writing communities. The Plain Writing Act of 2010 requires federal agencies to use clear governmental communication that the public can understand and use. The U.S. government website (www.plainlanguage.gov) includes excellent general writing advice, including addressing your audience, using concise language, attending to visual design, and testing your content.

Read More

A long-time member of the Shenouda Associates Inc. team, Donna Muldoon shares her entry into the technical writing business. Reluctant or not, her writing skills are strong and solid, and her editing skills are impeccable.  — Judy Shenouda

Donna-Judy

Donna, the reluctant writer, with Judy, the boss!

I am a reluctant writer.

From my first aptitude test in junior high to my last career counseling tests as an adult, I was told that I should be a writer. Even Mrs. C, my high school English teacher with the feared red pen, commented that I should be a journalist. But I always disliked writing. It was painful, a dreaded chore, whether it was a simple thank you note or a speech to be presented. Sometimes the words came easily, but other times, they wouldn’t come out of my pen no matter how soon that assignment was due.

But here I am—after 22 years as a technical writer—still reluctant to do any real writing. I’m defining real writing here as creative writing—the opposite of technical writing. For me, creative writing requires thought, imagination, attention-grabbing sentences, interesting characters, and maybe some human emotion. None of that is in my wheelhouse.

So, when a career counselor suggested that I consider technical writing, I needed more explanation as to what that entailed. The counselor set up a meeting with someone in the field, with the warning that this was not a job interview. With a business writing sample in hand and absolute certainty that no amount of information would convince me that writing was for me, I went to the meeting. The expert in the field turned out to be Judy Shenouda! Over the course of two hours, Judy explained the concepts of technical writing and showed me some examples. The sight of 200-page finished publications did not fill me with waves of excitement, anticipation, or confidence! But Judy made me an offer that very few people ever receive: I could try out working on a technical writing assignment for a month to see if I liked it. If Judy was willing to take a risk, there was nothing for me to lose.

The first 10 years, the next 10 years, and still counting

I tried out that job for 10 years, becoming the sole writer for one complex product that encompassed over 50 manuals, totaling more than 2,000 pages. In addition to becoming familiar with the product, I learned how to write using a controlled language, how to publish on FrameMaker, and how to build periodic CDs for the distribution of the manuals.

Skip ahead to now. Read More

Remember I wrote about Froggy who wonders what made that annoying wart wander away? Well, every now and then, I think about Froggy and his human friends who experience wellness, somewhat mystified as to how the healing really occurred.
I committed to writing Froggy’s story and I’ve made some progress. I’ve dipped into my own well, my reservoir, my creative source for exploring wellness. I needed a place to hold what pokes through the gray matter and created a template for my new book. I simply took the file for my earlier book, stripped away the content, and had place savers for a book title, subtitle, front matter, chapters, and end matter. I had styles for headings, paragraphs, lists, and quotes. With a container all set to go, I pasted my start to Froggy’s story into a chapter. With the momentum building, I was on a roll.
About This Book started to take shape.

Wellness is all encompassing. It touches all aspects of one’s being. Wellness permeates—and transcends—the person. When one is well, there’s a sense of wholeness, a sense that all is right with the world.
Annoyances, irritations, aches, and pain subside, fade away, dissipate, and disappear. One becomes open to the light. One is free to attend to the good, the sacred, even the holy.
Experts in various disciplines know something about wellness. The doctor… The nutritionist… The athlete… The naturalist… The musician… The entertainer… All have their take on the subject.
Yet, the composite from the many disciplines is not the whole story. A mystical ingredient exists. In the process of writing this book, I am hopeful that the known ingredients of wellness and the mystical might just meet.

The Dedication helped me to establish a timeline.
With my late mother’s 100th birthday one year from now, I have a goal—to honor the occasion with a book in hand, one that serves as an expression of a daughter’s love and admiration.
Progress is sweet.
What I have, thus far, accomplished are little steps toward turning an idea into a book. Yet, little steps are steps nevertheless. Progress is sweet. I feel good.

23570999_276678d100_b

Photo, Start Something by Martino Sabia, is courtesy of Creative Commons, https://www.flickr.com/photos/ezu/23570999.

Nature is filled with stops and starts that just happen, without any effort or coaxing from human beings. We see that the snow that covered the ground for months is almost gone, giving way to soggy soil and brown, slightly green grass. We hear the songs of robins and see crocuses popping through the earth. We listen, we watch, we shed our armor of heavy coat, hat, gloves, and boots and greet a new season. If only our work life stopped and started so naturally. If only we could recharge by pressing a magic button. My work world–and maybe yours, too–is filled with projects, where an element of angst accompanies the stops and the starts and, at times, the phases in between.

Stops

I now see the finish line approaching on one book project that has occupied my mind and energy for several months. The client is reviewing a draft that I will then tweak, as needed, and prepare for publication. It seems that the difficult work of transforming lots of content into an organized, readable, interesting book is almost ready to stop. There are some signs that this work, like the robin and the crocus, will sing and bloom. I will watch this spring as this book project leaves me and takes on a life of its own.

Starts

While my efforts on one book project are about to stop, I hem and haw about a new project that is about to start. Unlike the start of spring that, sooner or later, just happens, this new assignment, which is a chapter in a book that will have many contributors, is not miraculously taking shape. No, it needs some prodding, some cajoling, some poking around. Since this new book is a collection, there is already a theme to consider. Yet, what I want to convey in my chapter is vague. How and where do I begin? Read More

Practicing for our Singalong with Gert

Summer means it’s time to prepare Ma’s picnic for our extended family and her ever-evolving circle of friends. My role is to compile the list of invitees, send out the invitations, and, most important of all, prepare the handout, Singalong with Gertrude. Recently, I sent her the list of songs we discussed—a combination from previous years and a few new ones. I created the list and sorted it alphabetically. That way, I could easily identify and delete duplicate titles from the list. When I sent her the alphabetical list, she did not like the sequence! A singalong should not progress from Aba Daba Honeymoon to Zip-a-Dee-Doo-Dah. Musically, it makes no sense.

Of course, as a good daughter, I went through several revisions, and I think we now have it right. We start with Hail, Hail, the Gang’s all Here. We sprinkle some of the happy, smile songs throughout—Just Let a Smile be Your Umbrella; When You’re Smiling; and Smile, Darn You, Smile. We made sure that Ma’s favorite songs are at the top of the list, since with 50 songs, we may not sing them all. We will, though, conclude with the last song on the list, May the Good Lord Bless and Keep You. So variety and importance factored into the organization. Read More