Showing posts with label documentation. Show all posts
Showing posts with label documentation. Show all posts

Wednesday, November 15, 2017

Creating a Graphical Comparison Without Graphics

Long time, no posts. I'm trying to figure out where this blog fits in and whether or not I can (or want to) continue updating it on a regular basis. For right now, I'm just posting when the urge strikes... which obviously isn't often. Thanks for bearing with me.

--

Yesterday, I was working on a slidedeck that included a comparison of several different technical solutions. At the end, I wanted to convey a visual summary of the risks and benefits of each option.

Five minutes before I was to present the slides, I was frantically googling to find the perfect icons to use. I wanted some sort of red/yellow/green lights or gauges, some way to show high/medium/low risk or represent level of effort.

I couldn't find anything that I liked (and didn't have to pay for). I realized with just a minute or two to spare that I didn't need anything fancy for what I wanted to communicate. I could use simple colored bars in a table on the slide. 

I had started off with text (low, medium, high) and changed the color of the text to correspond to a rating. Then I added highlighting and adjusted some spacing so they'd all be the same width (which is why the text looks a bit funny). 



The resulting chart effectively conveyed my message. 



Just a little reminder that sometimes simple is best.

Wednesday, February 11, 2015

How I Use Jing, Clarify & Skitch to Train Salesforce Users on the Fly

"I'm trying to customize a report but my filters aren't working".... "I'm searching for an account but I'm not seeing anything in the results and it should be there".... "I don't see my opportunities."

In my role as a Salesforce Admin, I regularly receive emailed questions like this - not so complicated that scheduling a screen-sharing session is necessary, but not simple enough to warrant a "send me a link to the page you're on and I'll fix it" response. Often, it's a case of someone needing a little extra training.
Note: I've talked about this topic before (see this post: "How I Changed My Attitude Toward Internal Tech Support"), but I've updated my methods in the last few years.

I prefer to not just call someone up on the phone and tell them what to do. Why? Because...
  1. What happens when the person I'm helping forgets about our conversation and stumbles across the same issue? 
  2. Schedule and time zone differences tend to yield a thread of 'what time works for you?' emails that drive me nuts.
  3. When the question comes up again with another person, it's great to have a resource that I can share quickly. I'm saving my future self some time.
  4. Phone calls are disruptive. I'd rather they review my response at the best time for them.
  5. Showing is always better than telling.

To help me use these opportunities to teach people individually, I use these three tools:
Links: Clarify (from ScreenSteps) | Skitch (from Evernote) | Jing (from TechSmith)


To determine which tool to use, I consider how I can answer their question best.

  • Will a single marked-up image do the trick? Use Skitch.
  • Would I type a numbered list of instructions in an email in response? And would pictures be helpful? Use Clarify.
  • Can I explain this best by walking them through the steps personally? Use Jing.


How I Use Skitch

I prepare my screen so I'm viewing what I want to capture, then use the keyboard shortcut for a crosshair snapshot (meaning I 'draw' around the area I want to capture).

I use arrows, boxes or text to annotate the image as necessary, drawing attention to a button they should click on or a field that they need to populate.



Note: Jing can also be used for individual screen captures, but I prefer Skitch because I can drag and drop the images directly into Gmail.

How I Use Clarify


When someone asks me a question that will involve a step-by-step answer, I love to use Clarify. It's a quick and easy way to create one-of tutorials that combine written instructions with annotated images that show them exactly what to do.



I typically share my tutorials via a link, but there's also an option to export as a PDF or to Evernote.

How I Use Jing


Jing is easily accessed from my menu bar. I choose the area that I want to record and click to start the video recording.



Most of the time, I record audio so I can explain what I'm doing. But on occasion I leave the audio muted if no other instructions are necessary aside from a quick demo.

I keep my explanations brief - usually right around a minute. Then, with a click, I can upload the video, then the link is automatically copied and I can paste it in an emailed response.

The Result


Recording a short video, preparing a step-by-step tutorial or capturing my screen may take a smidge more mental energy, but it doesn't take much longer than composing some instructions in an email. The results have been well worth the effort.

I received this response today after I sent a coworker a video about how to customize an existing report.



Click here to see another example of the response I've gotten to this method.

Does your job involve providing tech support or training for coworkers? If so, what tools have you found successful? I'd love to hear about them in the comments.

Friday, May 16, 2014

Salesforce Admin Journal: Teaching a Man to Fish.... or at Least to Create a Report

I regularly receive requests from users to create a specific report. Often these are reports that no one else needs access to.

We are trying to cut down on the number of reports in the 'Unfiled Public Reports' folder. So, I'm encouraging users to save reports that they may need in the future to their 'My Personal Reports' folder.

I'm also working on teaching them how to create reports on their own. As I mentioned in this post from last year, I think it's important to educate people whenever possible rather than just doing something for them automatically because 'it will take me less time.'

This method doesn't just benefit me by reducing the number of request I will receive in the future. It also helps my users become more self sufficient and capable.

Today, a user chatted me a report request. In response, I recorded a one minute long tutorial that will help him learn the basic skills needed to prepare the report himself.

Here's the response I received:



That was totally worth the few extra minutes it took me to record the tutorial using Jing.

Wednesday, January 30, 2013

How I Changed My Attitude Toward Internal Tech Support

In the past, I've been inclined to have an 'it'll be quicker if I do it' attitude when it comes to providing tech support.
An important point to keep in mind if you're going to educate vs. enable is this: It's probably not going to save you time right now. You've got to think long term.
I recently realized that I was training my coworkers to be dependent on me. I decided I'd much rather educate than enable.

My new perspective:
  • I want to be prompt, polite and helpful.
  • I want the person I'm helping to be able to remember what I showed them.
  • In-person sessions can be useful but often forgettable and not everyone has the time.

With those points in mind, I've been putting a few handy apps and practices to good use to help me educate more and enable less.

Continue reading to find out why it doesn't always work, the name of my favorite app and how the magic actually happens.