Enterprise Software Training Curriculum and API inquiry
Nov 09, 2017
Hello Friends,
I am the enablement manager for a start-up software company and I am responsible for creating all the training and support content. I’m struggling to discover and or find any resources in regards to best practices or stellar examples of software training done through Articulate 360.
The idea is interactive, highly engaging and easy to digest information. The post that we currently have is about two years old so I figured I’d start a new one and see if we get any traction.
additionally, what are some of your experiences with API integration or what are the options.
Any advice is genuinely appreciated
taylor
15 Replies
Still looking for any insight, thank you for your time.
This is something that interests me as well. Did you find any solutions?
Hi Taylor - I build software sims, and my approach is usually task-based vs feature based. One of my favorite examples is a super oldy, built in Storyline 1! http://articulate.demos.s3.amazonaws.com/sales_orientation/story.html - I have always liked the way they approached the software part. Click on the "Sales Admin" job role and you'll see how they treated it. I also like Tom's http://blogs.articulate.com/rapid-elearning/create-interactive-course-using-single-image/ - not specifically for software, but I could easily see it working for some types of software.
Best practices for software training - that's a good topic idea! Feel free to reach out and maybe we can collaborate on an article and do some research together?
Hi Jane,
Here are two of my favorite examples:
I hope that's helpful! :)
Thank you, Holly. I appreciate your help. I like the concept of creating
an interactive course with a single image. I had a similar idea in mind.
I tried to run the sales job course but was not able to select the Sales
Admin role. The only hotspot on the page was to turn off the lights. Is
there something I have to install to run this course?
Jane
Thanks Allison,
Those are great examples of software courses. The task I am teaching is how
to integrate API calls into a C source code file. There is no graphical
user interface. It is based on C programming API function calls. There is
some overview information that has to be taught before the API workflow.
I'm trying to figure out how to make it interactive.
Jane
Ah ok! That is definitely an additional challenge. It's hard for me to really grasp what that could look like since without seeing a screencast of what you're actually teaching. Are you able to share that?
Hi Allison,
I can't send a screencast, unfortunately. What I would capture and send,
if I could, would be source code for a sample application in an editor.
The user would then follow these steps:
1. Include 3 header files to the top of the file
2. Add new variables that will be used as API function parameters
3. Add code to assign values to the new variables
4. Decide where to add the API calls
5. Add API calls in a specific order
6. Possibly add code to handle errors (unless we decide to leave this
out for simplicity)
This would serve as a simple example, but actual user code could be much
more complex when they actually integrate our API.
Before the user can make the code change, they need to understand
- The service they are integrating
- what the API does
- use cases for using the API
- key concepts
- how the API fits into the architecture of the service
Jane - here's how I would approach your course:
Use hotspots on where they'd enter the code (you could use whatever editor you like - notepad ++ or Atom or Sublime... When they click on the hotspot, then they can do a data entry field
If they enter the variables and code correctly, then they'd get confirmation feedback with context. If not, you could offer them a hint or other way to nudge them along.
You could then jump to a point where the API calls are already displayed (#5) and allow them to move the code into the right order, giving you a chance to give feedback.
You can also use multiple choice questions for #6. e.g "Now that we've got the API call set up, which code would you add to handle errors?"
You don't have to follow all the steps in a sim, you can do some data entry, and sprinkle in other things that give you an opportunity to add context and instructional feedback.
Hope that helps, let me know if I can help further!
Thanks so much, Holly. I love those ideas! I appreciate your help.
Jane
Hey, this post picked up!
So after a year of trial and error... lots of error. Here is what I /we have found the most effective for our training and KB content.
Tool Kit:
Process:
Goal: Self-service training structure to mitigate the need for additional support engagement and most importantly drive adoption.
Tips:
Thank you, Taylor, for the OP and your recent follow up post with tools, processes and tips! I am a fan of transparency and sharing how we do things with one another. My favorite piece of wisdom from what you shared is: "knowledge articles and training are not a platform to showcase how brilliant we are." This is so true - and so important to keep in mind for those of us creating software / systems training.
I'd love to connect and discuss ideas. Thanks Holly.
Laura, thank you for sharing your thoughts, it is always appreciated to hear what resonates with readers.
I love that you are using GIFs as part of the solution. Very clever.
The tips are great guiding principles - something that every project should include.
Thanks for sharing Taylor.
This discussion is closed. You can start a new discussion or contact Articulate Support.