Instructionsbe Tech Help



Teaching technology tips. Below we have provided a few suggestions for teaching and creating assessments when presenting Microsoft Office software and other technology topics in your classroom. For general teaching tips, see our Teaching Tips. Creating Microsoft Office assignments.

  • The Help Desk provides technical support for all College owned computer equipment purchased by IITS. Phone support, walk in, and 'housecall' support is available for most issues by contacting us. We can be reached by phone on campus at extension 3115. Off-campus or dial (315)-792-3115; You may also email us at helpdesk@utica.edu.
  • What’s next for hardware, software, and services. Then it might help your nerves to take a step back. Not feeling like you have clear instructions can be frustrating, to say.
  • Welcome on the support page of WIDI by CME. This is the page where you can find useful information about Bluetooth MIDI and WIDI devices. You can scroll down and learn more about Wireless MIDI (WIDI).

There are some tutorials that require more than text to be understood by readers. By creating step-by-step instructions using visuals, you can key readers into details that may otherwise not have been communicated. Those visuals could be still images or screenshots, animated GIFs, comparison charts, or videos. On top of helping readers understand your content, visuals also break up the monotony of a large amount of text.

In the last year, I’ve been working as a technical writer for Joyent writing instructions and creating videos geared towards users of all skill levels. This requires precision — people rely on me to create step-by-step instructions and guides for a technical task. If I miss a step or assume that readers already know a piece of information, they may walk away frustrated and never come back to our content. On the other hand, if I’m too detailed the content could feel excessive and rambling, as well as require more frequent updates. No pressure.

TechInstructionsbe Tech Help

Finding the places where an image can replace some of those overly precise details saves me time and energy. Plus, readers walk away knowing what they’re expecting to see which hopefully makes their life easier. Whenever possible follow some key writing advice: show, don’t tell (so essential it has its own Wikipedia page).

You don’t need to be a technical writer to benefit from precise process parlance. Keep reading for strategies to prepare instructions and add visuals to any document.

Before you start visualizing, consider your audience

Before producing any content, you should know who you’re producing it for and what their expectations are. Although it’s impossible to anticipate each reader’s individual needs, the rules you establish influence the tone of your content and can help you make decisions later down the line when creating your process outline.

Consider the following:

  • Are my readers already experts? Have they done this process before, if not exactly then in similar circumstances?
  • Are my readers internal or external? If my readers are within the same company, what language do we share that will help better explain the process?
  • What mood will they be coming to my content with? Am I creating this content for someone who is in a rush to get something done, or is this for a more casual learner who is just hoping to further their education on a topic?
  • What is most important to my readers? What is least important?
  • How do my readers prefer to learn? Do I know if a blog post is more successful than a video? Is there any analytical data to support these claims?
  • Are my readers native English speakers? If I use an idiom, will it hinder their ability to learn how to complete the process?

No matter what you’re creating, you’re always creating it with a reader on the other end. The better you know your reader and produce content with them in mind, the more likely they’ll keep coming back for more content.

Outline the process with only as many details as necessary

One way to prepare a process or tutorial for any medium is to start with a two-column table. The first column will contain each individual step that the reader needs to take to complete a task. Those steps can be as small and precise as “submit your application” or as large and unspecific as “complete the remainder of the form.”

The second column will be your visual process column. At first, this may not include any actual visuals at all, but a description of what the visuals will be. If you’re creating a written document, you don’t need to have a matching visual for every step in column one. If you’ll be creating a screencast, every box should have a note about the type of visual to be included. There should be little to no empty screen time in a video.

An example of this table is below under “Example Outline,” but first you have to know more about the types of visual aids.

Types of visuals and when to use them

Every process can benefit from different types of visuals. The medium will change depending on its purpose.

  • Still images – this is the perfect medium when trying to visualize a physical product, be it a person or specific object like a type of pan. These can be stock photographs or photos you’ve taken.
  • Screenshot – a still image of your screen is great when talking about products that are seen on your computer, such as a website or another piece of software. They’re super easy to take and edit, especially thanks to Snagit.
  • GIF – animated images are perfect for explaining short processes (under 8 seconds) which may not be as easily articulated.
  • Chart – bar charts, pie charts, line charts, so many types of charts! A chart is the best choice when talking about and comparing a set of numbers.
  • Video – the ultimate visual, a video is great for explaining a process. How to make a great technical video is an art form which can certainly be helped by this process but requires much more planning. (Lucky for you, I learned a lot from TechSmith, and they have a lot more to say on the subject).

Instructionsbe Tech Help Desk

Feel free to use a mix of mediums with your writing. Each will meet different needs for different steps.

Example outline

Recipes are one of the best examples of a process that often requires precision in which visuals can make a huge difference. Let’s say I want to outline the instructions for making a cake:

table {

border-collapse: collapse;

}

table, td, th {

border: 1px solid #404040;

padding:4px;

}

STEPSVISUALS
1. Gather all of the ingredients to ensure nothing is missing. If an ingredient is missing, acquire that ingredient before continuing.Picture of assembled ingredients
2. Preheat the oven to 350 degrees Fahrenheit.
3. Grease and flour a 9 x 9 inch square cake pan.
4. In a medium bowl, cream together the sugar and butter.GIF of creaming process
5. Crack the eggs into the bowl one at a time, stirring to incorporate.
6. Stir in the vanilla.
7. Sift the flour and baking powder in the bowl and mix until just incorporated. There may be clumps or streaks of flour left.GIF of sifting or photo of finished stirred product pre-milk
8. Stir in the milk until the batter is completely smooth.Photo of finished batter (possible side by side with picture for step 7)
9. Pour or spoon batter into the prepared cake pan.
10. Bake for 30 to 40 minutes in the preheated oven.The cake is done when golden brown on top. The top should spring back to the touch.Photo of finished cake

If every step had an image, that would be a bit… gratuitous.

Choose your visuals

The images I’ve selected are helpful in articulating mini processes within a larger process. In particular, the picture in step 7 of the mix stirred so far is a crucial piece of visual evidence. Having baked a number of cakes with this instruction, the difference between just right and over-mixed… I wish I always had a picture. There could be an instruction manual written just on the intricacies of how long to mix — every other page would have to be an image.

After outlining what visuals you need, you have to collect the goods. For this example, it would be best to take pictures of your process baking a cake. For other processes, you may not need to take custom photos. There are a variety of free and premium stock photography websites which have videos, GIFs, and still photos to be used at your discretion.

Testing with your target audience

No piece of writing is complete until it has been read by someone in your target audience and given a seal of approval. Their input will demonstrate where you missed a step in your process or where more visuals are needed.

The easiest way to go about this (without the large resources of a usability team) is to ask a few people from your key demographic to read your content and try to follow the process exactly as written. Jakob Nielsen is often quoted saying that five is the best number of people to catch the most number of issues.

Unmoderated testing

Unmoderated testing is perfect for smaller projects with limited resources — or just when you need results fast. There are a number of tools you can use for more precise results, but if you’re just looking for feedback on a smaller process, you may be able to get away with just sending the document to your testers with a set of questions you want answered.

Ask your testers to take notes whenever they have questions, see something that may be missing, hit roadblocks in the process, or wish they had more detailed instructions. Hopefully they’ll be able to finish the task before giving you feedback.

Moderated testing

The biggest benefit of moderated testing is that you can actually watch your tester perform the process and see where they are confused instead of relying on them to note that confusion for you. It’s even better if you record the session so that you don’t have to rely exclusively on the notes you take during this session.

Ask questions along the way. For example:

  • Did you understand what task you were being asked to perform? Did that task make sense?
  • What would have made this process easier to complete?
  • If there was a visual with a step, did the visual help you understand what to do?
  • Do you wish there had been more visuals?

Wrapping up

You now know why you should add visuals to step-by-step instructions and have an arsenal of tools to help you successfully create step-by-step instructions with the help of visual aids. Practice makes perfect. Your first attempt at adding images to a process may not be perfect, but with some user testing to guide your editing process, you’ll be on your way to helping your users understand how to complete a task.

Do you have another method of figuring out when to add visual aids to instructions? Share your tips in the comments below!

Editor’s Note: This post was originally published in November 2017 and has been updated for accuracy and comprehensiveness.

Related Posts:

If you ask us, technology is pretty amazing. The possibilities are endless, if you know where to start. That’s where we come in. Our Explained series helps you get the most out of your tech and makes life just a little bit easier.

Today, we’re able to wirelessly connect more devices than ever before. From our phones to our cars, smart TVs to smart speakers, fitness watches to wireless earbuds, the possibilities are endless thanks to Bluetooth technology.

You’ve probably heard of Bluetooth, but maybe you’re not be familiar with how it works or how many uses there are for it. Let us show you. Keep reading and you’ll see just how useful Bluetooth can be for connecting you to your tech.

What is Bluetooth exactly?

Bluetooth is a wireless technology that sends data over short distances using radio waves in fixed and mobile devices. Basically, this means it allows you to play music from your phone through a wireless speaker or talk hands-free while driving your car.

What is Bluetooth pairing?

Pairing is the process of connecting two Bluetooth devices. The steps you’ll take to complete the pair will change depending on which devices you have (phones, speakers, watches, headphones, TVs, etc.). Be sure to check each device’s instructions for information on discovery mode, pairing requirements, and more.

When your device is in pairing mode, it should display a signal in the form of a flashing light or small sound.

Tech

How do I connect multiple Bluetooth devices?

There’s no difference in the pairing process; however, sometimes two devices of the same kind cannot be paired simultaneously. For example, a set of wireless headphones and a Bluetooth speaker cannot be paired to the same device at the same time. However, you can pair AirPods and an Apple Watch to an iPhone at the same time.

Does Bluetooth drain your phone battery?

When a device checks for Bluetooth connectivity in the background regularly, it will consume a small amount of your battery life. For those who have devices with batteries that are two years or older, it’s recommended to disable Bluetooth when you don’t need to connect.

For tips on how to avoid draining your battery read this.

Okay, let’s get to the fun part – get ready to pair!

How do I connect a Bluetooth device to iPhone or iPad?

  1. On your phone, open Settings app and tap Bluetooth.
  2. Make sure Bluetooth is turned on (the button should be green).
  3. Check your Bluetooth device to make sure it’s turned on and in discovery mode. Wait for it to show up under My Devices below the Bluetooth setting on your device.
  4. Tap the device name you want to pair with to initiate the connection. You may be asked to input a special code, but only if the device you’re connecting with requires one.
  5. Your device is now ready to use when it shows “Connected” next to the name of the device. If it shows “Not Connected” simply tap the device name again to reconnect.

Does Apple Homepod have Bluetooth?

Instructionsbe Tech Helpline

Unfortunately, no, the Apple Homepod can’t connect directly to your Bluetooth devices. Instead, it uses the Apple Airplay technology and utilizes Siri to control the phone to speaker commands. At this time, Homepod is only compatible with other Apple Airplay devices.

How do I connect a Bluetooth device to Android?

  1. On your phone, open the Settings app and tap Bluetooth (or Settings > Connections > Bluetooth).
  2. Make sure Bluetooth is turned on (the button should be blue).
  3. Check your Bluetooth device and make sure it’s turned on and in discovery mode. Wait for it to show up under Available Devices on your phone.
  4. Tap the name of your Bluetooth device under Available Devices.
  5. Your device is ready to use when it shows “Connected” next to the name of the device. If it shows, “Not Connected” simply tap the device name again to reconnect.

How do I connect an iPhone or Android to car Bluetooth?

If you’re connecting to your car, these steps are slightly different than the ones listed above. Start by selecting Source on your car stereo, then press the button for Bluetooth Audio (sometimes labeled BT Audio).

Steps for pairing will vary depending on the make and model of your car, so check your user manual for specific instructions. In most instances, you’ll use your car’s digital display screen to connect your device. You may be prompted to enter a PIN or code to pair your device. This PIN or code should appear on your car’s display screen and you’ll need to enter it in your device to establish the connected.

Once your device is connected, you’ll see the Bluetooth icon appear on your car’s display screen.

How do I connect a Bluetooth device to a PC computer?

  1. Turn your Bluetooth device on and put it in discovery mode.
  2. Turn your PC’s Bluetooth on:
    1. On the task bar, select Action Center > Bluetooth.
    2. If you don’t see the Bluetooth icon appear on the task bar, select the Startbutton, then select Settings > Devices > Bluetooth & other devices and click the button to turn Bluetooth on.
  3. In the lower right hand corner, click on the Bluetooth icon, select Connect > the name of the device you want to pair.

When your Bluetooth device is on and in connectivity range of your PC, it should connect automatically after the initial pairing.

How do I connect a Bluetooth device to a Mac or Macbook?

  1. Turn your Bluetooth device on and put it in discovery mode. If you’re unsure how to do that, check the device’s pairing instructions.
  2. On your Mac, click Apple menu > System Preferences and click Bluetooth.
  3. Select the name of the device shown on the list, then click Connect.

When your Bluetooth device is on and in connectivity range of your Mac, they should automatically connect.

How do I connect a Bluetooth device to Amazon Echo?

  1. Set your Echo and the Bluetooth device near each other; at least three feet apart, preferably.
  2. Turn your Bluetooth device on and set it to pairing mode. If you’re unsure how to do that, check the device’s pairing instructions.
  3. Be sure you have the Amazon Alexa app downloaded to your device. Using the Alexa app, select the Devices icon and choose the name of your Bluetooth device.
  4. Select Bluetooth Devices > Pair a New Device.
  5. When a list of available Bluetooth devices appears, select your device and follow the instructions on the screen.

How do I connect a Bluetooth device to Google Home?

  1. Turn your Bluetooth device on and set it to pairing mode.
  2. Make sure you have the Google Home app downloaded to your device. Open the Google Home app to begin the pairing process.
  3. Tap the name of the device you would like to pair with the Bluetooth speaker.
  4. Tap Settings in the top right corner > Default music speaker.
  5. Tap Pair Bluetooth speaker. Tap the device once it appears on the screen.

Remember, you can only have one connected speaker or set of headphones at a time. You’ll need to disconnect from one to connect to the other.