Mr. Procedure’s Mad Cap Adventures — Introduction

I am a career Office worker. Not that I have worked in an office my whole life, but I have worked with Microsoft Office (at least since Word Perfect was purged at my prior employer). I have developed documents almost exclusively in Word and training presentations in Power Point.

But the allure of authoring software has always been there, at least since 1998 when I first encountered Authorware, which I believe was a Macromedia product. But each time I  confronted a situation where authoring software would have made sense, I stayed the course, literally beating Word and Power Point into submission until I got what I wanted. Over time, I prided myself on being able to do anything with either program the long way.

But now things are different. In my current position, primarily focused on developing user manuals for technical processing equipment, I have found myself using the same content multiple times (e.g., describing software screens that do not change from system to system). This is fine, except when I drop a piece of copy from one manual into the next, I have to do a lot of content-shuffling, to get everything to look decent on the page.

So on November 1, 2012, I officially took the plunge into the world of authoring software. (Oh, I dabbled in Captivate, but only briefly before I reverted to Power Point.) This afternoon, I downloaded my newly purchased copy of Mad Cap Flare, version 8. I talked my organization into obtaining the software with the promise that I could do more, and do it more quickly, with Flare. Now, of course, I have to prove myself correct.

So over the next few weeks, I will post my progress in learning the software and–I hope– becoming more effective in my work. In case you are wondering, I am not an undercover  Mad Cap employee trying to gain sales. I have no affiliation with Mad Cap, so I can be honest and direct with my struggles and (I hope) triumphs. I will not treat this as a “product review,” but will do my best to communicate the process as a 50-ish, not-so-tech-savvy writer attempts to make a transition into a higher level of performance and proficiency.

If you are a Mad Cap Flare user, or user of another authoring program, please feel free to join the discussion. Laugh at me, tell me I’m making it too difficult on myself, there’s a better way to do it and here’s how (I especially hope to get comments in the last vein). I look forward to sharing this adventure with you.

Posted in Authoring Software, Culture change, Instructional Communication, Process, Training Program Development | Tagged , , | 1 Comment

My Answers from LinkedIn (Fifth in an Occasional Series)

Do Good Trainers really NEED PowerPoint?

I’m not a fan of PowerPoint, and find it too restrictive for learner-centric training. So, I don’t create PowerPoint slides for my materials unless they are specifically requested. Am I out of step with most trainers out there, or DO PowerPoint slides restrict sessions unnecessarily?

You phrased it very interestingly, “am I out of step?” Once we become concerned about whether we are in step or not, we have lost the focus as to why the training is being conducted, and the effectiveness suffers. There is no one “step,” lest we get someone
believing every single training project must be executed the same way. My use of Power Point depends on the type of training taking place. In most cases, Power Point serves as a reference point for the discussion: I use it as a personal placeholder, but also make it available (by providing a set of slide prints in my course materials) for those class attendees who like to take margin notes for each slide. I will also use the animation features of Power Point to illustrate process actions (paths of chemicals through a process,
e.g.). A very general plan of attack, but very effective is to do the following: identify why the training is taking place, and where the learners need to be (in terms of understanding or capability) at the end of the training. Then I determine what tools, learning, activities, etc., will best achieve the desired outcome. If Power Point fits into the plan, use it for all
it’s worth. If it provides no benefit, then set it aside. But the answer will change from project to project. Power Point is a great tool, just like a hammer is. But not every training process you face is a nail.

Posted in Uncategorized | Leave a comment

My Answers from LinkedIn (Fourth in an Occasional Series)

As noted in the first post of this series, I am posting answers to procedure and training-related questions posted on the LinkedIn groups I participate in. As appropriate, I will expand on answers here (read, I thought of additional things to say).

A training question, which I actually find more rewarding than procedure development (since procedure development is aimed to facilitate effective training)

Experienced producer but first time trainer needs some advice. Next month I start running courses teaching business people filming and presenting techniques. I know my subject as I’ve got 23 years broadcast experience behind me, but devising and running training is new. What are your top tips as well as the pitfalls to avoid? Thanks for your advice.

First
of all, congratulations! I have always loved training and while my professional focus today is more on writing, I still develop presentations for the engineers who install my company’s systems and teach our customers how to use them.

I will try to boil this down to a few essentials:

1. Be enthusiastic and passionate about what you will be teaching. A big part of successful training and teaching is convincing your students that what you have to share actually matters and will make their lives better by learning. If you exhibit passion for the subject matter, they will more likely become passionate as well.

2. Building and presenting training is like building a building. The foundation you lay is essential. You want to be able to lay out a plan for the training: this is the basic topic (a position, a role, a task, whatever); here is what the topic consists of; here is how we will learn it and here is how we will measure the learning.

3. Be able to identify what the students will be able to do at the end of the training. That ties in with no. 2.

4. Break the subject matter into manageable pieces. In training, I use a concept that I liken to “wading into progressively deeper water.” I start with basic stuff and “foundational
truths,” that I will circle back to repeatedly as I layer new information onto old (that is an effective adult learning technique).

5. Define all terms you use. As an expert, be very careful about the terms and jargon you use. You can very unintentionally build a barrier between you and your audience by talking like an expert while they are novices.

6. Give lots of opportunities for feedback. Ask open-ended questions, use examples that may be commonly understood by the audience.

7. If at all possible, move rapidly between lecture/discussion and hands-on activity. The human mind shuts down after about 40 minutes of non-stop yakking.

8. Always be respectful, remembering there are no stupid questions, and one of the quickest ways to block a learner is through disrespect.

9. Be aware that this is a learning experience for you as well. You may know your subject through and through, but through sharing and repetition, you will discover more effective ways to present the information. Be cognizant of what works and what doesn’t. And prepare yourself now for some things not to work. If something falls flat, admit it and move on. If you never make any mistakes in your training, you have only proven you have not reached your performance limit (you can’t know your performance limit until you’ve
passed it and had a “crash and burn” experience. It will happen, but it’s not the end of the world.).

10. Be as determined as possible to make the experience as fun as possible for you and your learners. People learn more in a fun environment.

Each of these points above can easily be expanded into a whole series of posts. The intention of this answer was to lay a foundation. Training is a very rewarding job, and the aim should be to make it a mutually rewarding experience for both learner and teacher. If one of these points strikes you the reader as one you would like to see expanded, let me know!

Posted in Uncategorized | Leave a comment

My Answers from LinkedIn (Third in an Occasional Series)

As noted in the first post of this series, I am posting answers to procedure and training-related questions posted on the LinkedIn groups I participate in. As appropriate, I will expand on answers here (read, I thought of additional things to say).

Share your thoughts on creating Standard Operating Procedures for first level support. What should be the outline of this process document? By first level support, this is for  an Application Help Desk Analyst to understand the process of handling incidents (Incident Management Lifecycle). The objective is to fulfill the maintenance request, streamline Incident management process and daily activities list and to restore the service as quickly as possible in cases of service interruption.

The answer to this development problem is really no different than it would be to establish procedure and training requirements in any department. Here, you will want to create a complete description of what an Application Help Desk Analyst does. This will likely end up being a little more involved than just one or a handful of SOPs. In a nutshell, this is what you should do:

1. Create a list of activities or tasks that the Analyst performs. For each activity, you will want to identify the end product (in this case, it appears the “end product” is organized information) and who receives it.

2. Define the best way each activity or task is carried out. For this to be effective, you will need to consult with the end users of each “product.” It may be that the current product as delivered could be made better.

3. When the best way to perform each task is understood, describe the tasks in one or more SOPs. Generally, the SOPs will align with the tasks (the task list created in step 1 in essence becomes your “shopping list” for procedures).

4. When the procedures are completed, train the Analyst in each procedure. As would be helpful, you can create visual helps to use as references (i.e., once trained, the Analyst would not need the whole procedure at his/her disposal, but a brief help visual would reinforce the learning). The procedures may be supported by work instructions, which are documents the worker has at their side while performing the task.

5. After training, measure learning, and more importantly, measure performance to determine how the procedures and training are working out.

I hope this is helpful. Note that when I discuss operating procedures and work instructions, I am not necessarily dictating that they be on paper. There are many ways, including online, that could prove more useful. That is a function of the particular work environment. But the need to fully capture a picture of the work that is done, and then to fully describe that work, exists independently of the type of position and the manner in which the information is presented.

Posted in Uncategorized | Leave a comment

My Answers from LinkedIn (Second of an Occasional Series)

As noted in the first post of this series, I am posting answers to procedure and training-related questions posted on the LinkedIn groups I participate in. As appropriate, I will expand on answers here (read, I thought of additional things to say).

Is there a criteria that must be met to be able to know when a PPM is needed? How do we measure the success of PPMs?

After clarifying that the acronym PPM meant “Policy and Procedure Manual,” here was my answer:

Policies and Procedures Manuals are needed in any situation where policies and procedures are necessary to maximize performance and minimize loss. ISO-9001 Quality Management System standard requires that certified organizations have a “Quality Manual.” This presumably means a manual that contains documents that support the
organization’s quality operations.

ISO, however is sketchy as regards what belongs in the manual. The current revision of ISO-9001 only contains requirements for six written procedures: control of documents, control of records, corrective actions, preventive actions, internal audits and control of
non-conforming product. The organization is free to determine what additional
policies and procedures they believe will facilitate quality control. ISO requires that processes that impact quality be controlled, but not necessarily by specific documentation.

Where does that leave us? Policies and procedures should be developed by any
organization in cases where 1) some regulation or statute requires them (EEOC policies, for example), 2) where the establishment of policies is necessary to clarify responsibilities and expectations on worker behavior, and 3) where the development and deployment of procedures increases the likelihood of process success and waste/cost avoidance.

To your second question above, measuring the success of policies and procedures involves a review of activities, annually or more frequently, to determine the quality performance of the organization and to determine the degree to which policy and procedure implementation aided quality (improvement), hindered quality (improvement) or had no effect. This is the ISO concept of quality review (ISO clause 5.6 I believe). Measurement criteria can include prevention of defects, scrap rate changes,  improved productivity, customer satisfaction, and any other metric that leads to bottom-line success. Out of a quality review comes quality planning, in which actions to improve quality are developed (which may include policies and procedures). At the end of each review cycle, results are compared with improvement efforts to measure effectiveness.

Note on procedures and policies: even though only six written procedures are required by ISO, any time you put a procedure in place, you are now bound to follow it as written. You cannot claim during an audit that a procedure is optional because it’s not one of the “required six.” If you determine a procedure is necessary, it is presumed the procedure
describes the best way to perform the process, and doing it “according to procedure” is required (a self-imposed requirement, but a requirement nonetheless).

This answer prompted a second question from the original poster, regarding the criteria for Quality Reviews. My response:

The ISO clause on quality reviews does specify the elements that must be included in
the review (5.6.2). These include the results of audits, customer feedback (which can be both internal and external, depending on who consumes your product), process conformance information, preventive and corrective action status, and the actions developed in previous quality reviews (if any). This is a partial list from the standard.

If you have any questions you’d like me to tackle in the blog, you can write me directly, rather than waiting for someone on LinkedIn to ask. Leave a comment here or write me directly at mrprocedure@gmail.com.

Thanks and keep writing!

Posted in Uncategorized | Leave a comment

My Answers from LinkedIn (First of an Occasional Series)

I have been an active participant in several LinkedIn groups, most of which are concerned with Technical Writing and Training and Development. (Note to LinkedIn: I have been waiting months for some groups to act on my request to join.) Every now and again, I actually get a blip on the radar as a “top influencer.”

But part of the fun of group participation is joining discussions, especially when the discussion is around some question a prospective tech writer or trainer has asked. Sometimes my answers are “liked,” many times other knowledgeable people jump in and add their wisdom and expand mine.

One day, it dawned on me that the questions in the discussions would make good blog post material, since many of the questions are common to instructional communicators. I will take the liberty to expand my answers here from what was posted on LinkedIn. So, as questions of interest arise, I will bring them to this forum. And of course I will try to drive as many of my LinkedIn friends over to the blog as possible.

What is the standard format/layout if you are going to document processes/procedures?

A “template” or format for documenting processes and procedures should be structured to aid the learner. There is no “official” template mandated by ISO, though some regulatory bodies may mandate a certain format. If you are writing in such a regulatory environment, you have to consider the regulatory body as a customer for the document, and meet their requirements. For those of you in such situations, you have my sincerest condolences.

For years I have used a format based on the OSHA Process Safety Management (PSM) standard. I have found the format very useful regardless of whether the actual activity is PSM-controlled. In a nutshell, here is the format. This version is based on a procedure for a particular piece of equipment, though it can be altered for non-equipment focused processes:

1. Introduction–puts a fence around the subject matter, promises the document will focus on a specific task or set of activities

2. Equipment description–describes basic function of equipment, key components, safety features, limits of operation if they are applicable

3. Equipment controls–describes what each control, gauge, indicator, etc. does, how it is used.

4. Setup of the equipment*–describes how the equipment is set up; pre-checks of components, adjusting, getting everything ready for the run

5. Operating the equipment*–describes how each activity during actual equipment productive operation is performed

6. Response to upsets or problems*–what to do if equipment fails or operates outside of limits, how to recognize an escalating problem, how to mitigate, emergency response, restart after emergency response

7. Equipment shutdown*–how to bring equipment to a stopped condition, and have it in condition for its next use (cleaning, replacing parts if necessary), how to handle product resulting from process, paperwork.

* sections that include detailed activities, described in a sequence of numbered steps

This format is what I call “wading into progressively deeper water.” That means I share some information early, and each subsequent section builds on what has been presented before. In this manner, the learner builds a vocabulary and understanding of the equipment or concepts. The format is also very amenable to on-the-job training, as the
reading of the procedure sets the learner up for greater understanding of the hands-on training components, and allows the trainer to complete the hands-on portion while spending less of his/her time.

This is a summary of the discussion that appeared as an eight-part blog series called “The Procedure and Training,” where I expand on the sequence of information summarized above, and provide more useful information for the procedure developer.

I reiterate that there are multiple ways to develop and structure procedures. If someone has a system that works, I would not attempt to impose my will on their structure. But far more often, procedures are not achieving their desired outcomes, and structure is often one of the reasons the procedures are not working.

Posted in Uncategorized | Tagged , , | Leave a comment

A Return to First Principles (Part 12), Institutionalizing the Process

The outcome of the process analysis effort is that I have defined the very best way I currently know how to perform the process. That is, I know the way to most effectively achieve the process desired outcomes with minimal waste.

All that remains is the development of the procedure (and you know how to obtain a copy of the Writing Procedures course, where we describe procedure development and structure).

Actually, I lied in the last paragraph. Yes, the procedure has to be developed, but this is hardly all that remains! If I consider the procedure to be the standard for performance and I desire to ensure all future process performers perform the process this best way, then the procedure is just one step in what I call institutionalizing the process.

(Note: more than one person has suggested I need institutionalizing more than any process, but someone has to have an off-the-charts passion for process description, learning and improvement. ☺*)

Anyhow, the procedure must be supplemented with training of all personnel in the now-standardized best way to perform the task. This must be followed with an intentional enforcement of the procedure. “Enforcement” may be a rather harsh word to describe what I intend, but it is important that everyone knows performing to standard is non-negotiable.

Finally, every process performer must be aware that what we have is the current-state best way we know how to do it. We will likely find better ways to perform aspects of the process, meaning we will have a better future-state method. Workers must be able to share their ideas, but also be aware that they make no changes to their performance until the prospective improvement is evaluated and the anticipated positive impact is verified.

And–shudder!–this whole process improvement can be undertaken again to look for ways to improve further. The good news is you should already have plenty of information from the last improvement effort!

* The happy face was inserted using the ASCII code 1. There are 256 different ASCII codes; to insert one, hold down the ALT key while typing in the number of the code using the numeric key pad on the keyboard. After typing in the number, release the ALT key and the character will appear in your document. ASCII codes include codes for European letters (ü, for example is ALT + 129). Two common codes I have used to develop procedures are ALT + 241 (± sign) and ALT + 248 (° or degree sign). And to provide a negative happy face, type ALT + 2: ☻ And with that, have a nice day!

Posted in Continuous improvement, Instructional Communication, Policy and Procedure Development, Procedures, Process, Training, Training Program Development | Tagged , , , , , | Leave a comment

A Return to First Principles (Part 11b), Unearthing the Treasure!

Process analysis and improvement are not for the faint of heart. There is a lot of work that has to take place. I hope the reader appreciates that what I am doing here is scratching the surface of analysis and improvement methods. There is much more to be said, and I have said it in other venues, but I have already given one free book and I at least need to keep something to sell someday.  🙂

But let’s continue our discussion of deducing the one, current-state best way when a number of workers have “their own way” of doing it. Keep in mind also that when undertaking an improvement effort, you should have two objectives: capture a description of the best way to perform the task, and educate the workers regarding the fundamentals of process, waste, desired outcomes and why finding the best way matters.

The quick description of the improvement process looks like this:

1. Establish a “top level” sequence of actions that collectively describe (or more accurately, outline) the process.

2. Review in detail each of the top level steps. Have workers define: what constitute the beginning and end point of the step, how they do it, and why they do it (what they are trying to accomplish by doing a step a certain way). Note: it may be necessary to construct multiple Purpose Maps, each with different sets of detail. Don’t forget, the harder you work at this, the greater your prospects of improvement.

3. Identify what is expected of the step: what are the desired outcomes at the end of the step. (This step may require the involvement of process designers or others  with specific knowledge.)*

4. Analyze the steps or actions in light of the desired outcomes, and classify each action in terms of the four possibilities described in Part 9 (no effect, meets desired outcome, fails to meet desired outcome, not sure).

5. Work the process! In short, the intent is to remove all actions with no effect, establish and standardize the actions that directly and positively impact desired outcomes, change the actions that aren’t working, and study to better understand what you don’t at present.

6. You are about ready to reduce the understanding of best practice to constant practice, through creation of the procedure.

* One way to evaluate desired outcomes is to look at the finished output and determine all of the factors that define the output as acceptable. If it’s a product, these may be communicated in terms of the Three Fs: form, fit or function. If I have a list of the desired outcomes, then I know that somewhere in the process I must impart each of these features, and retain them through the end of the process.

Posted in Continuous improvement, Culture change, Policy and Procedure Development, Procedures, Process, Training | Tagged , , , , | Leave a comment

A Return to First Principles (Part 11a), Unearthing the Treasure!

The quest: to find that one, real, current-state best way to do the task.

The reality: the best way likely contains elements of the performance of several workers.

Of course, you may encounter some resistance in your quest. Let’s look at some issues:

Does finding one best way really matter, if everyone is doing fine with their method?

Yes. For lots of reasons. First, to the degree that anyone is not doing the task the best way, waste is being created. Waste should never be tolerated.

Second, if I have one method and all workers are following it, I will be able to respond more efficiently and quickly if a problem occurs. Problem analysis (which we will tackle at some future date) involves identifying “candidate” causes, then working to eliminate them. If I have to sort through 15 methods for clues instead of one, my problem takes longer to solve and costs me more in waste.

Third, if workers are doing what works for them, they may not recognize a step or action that is necessary for a non-product-based result (e.g., safety). Workers may be creating inadvertent hazards that suddenly arise, and workers will almost certainly be unequipped to solve a problem they didn’t know could occur.

Won’t I create hurt feelings for those who see their method replaced?

That depends on the nature (specifically, the culture) of your organization. Do you have a personality-driven, competitive culture, or a culture that prizes process excellence? If you have the former, you may have hurt feelings. More importantly, you have a culture change challenge ahead of you.

If your culture is the latter, you are ahead of the game. In either case, all workers should be part of the process analysis. As an action is pondered, you can educate your workers in considering actions in light of desired outcomes. And allow all workers the chance to discuss why they perform a specific action.

What if workers aren’t willing to go along with the new procedure?

Go back to the process vs. personality focus discussion (cultural factor). Bottom line is that the workplace is not a democracy, and functional workplaces are those where the process is the thing. Workers are generally not allowed to set their hours, or decide what work they will perform. There is no reason they should have any say in how a task is performed, once their input has been factored into the creation of the “new” process (which is really the coalescence of a bunch of old methods into the current-state best way).

Posted in Continuous improvement, Culture change, Instructional Communication, Policy and Procedure Development, Procedures, Training | Tagged , , , , | Leave a comment

A Return to First Principles (Part 10), Do I Really Know the Best Way?

The exciting aspect of process analysis is the learning you will gain. Of course, the amount of learning will increase with the amount of work put into the process analysis.

Remember that process analysis is based on the three characteristics of a process. One of those characteristics is, there is one, single current-state best way to perform the process.

Now here is where it gets interesting! What if you have multiple people performing the activity? (And the majority of activities are performed by multiple workers.) And, to compound matters, what if you have a multi-shift operation, where people on opposite ends of the clock are doing the same task? Is there really one best way to do it?

Some would argue that several “good” ways to do the task. Different people performing the task, multiplied by several shifts, and multiple generations of performers (i.e., newer workers being trained by experienced workers), can result in an “evolution” of methods. In fact, I could have multiple branches of evolving performance, all of them “good” by the measure I am using to define process success. So–I ask again–is there really one best way to do it?

The answer is…..yes, there is still one best way. Here is the rub, if you will…that one best way may be spread over several workers and several shifts. In other words, elements of each evolved method may contain portions of that one best way.

Unearthing the real one best way will become a treasure hunt akin to the Forty-Niners (gold prospectors, not football players) swarming into California in search of the gold that gave the state its nickname. We will pursue this thought in the next installment of the series, but I will warn you again: hard work ahead!

Posted in Continuous improvement, Procedures, Process Analysis, Purpose Maps, Training, Training Program Development | Tagged , , , | Leave a comment