This document is your AvoMD builder reference manual. No matter how many ALGOs you have created, it should cover everything you need to know. This guide will take you from creating a brand new ALGO to customizing already drafted ALGOs ahead of publication. As you progress through, all documentation sections are listed on the left bar and images or videos will be included where appropriate. Let’s get building!

<aside> 💡 Questions? Please reach out to [email protected]!

</aside>

Getting Started in the Builder

Pen Before Pixel

Clinical guidelines can become very complicated very quickly, so we recommend drafting your ALGO on paper before jumping into the builder. This way, you can consider the logic of your ALGO and easily make any adjustments on paper before diving into the builder environment. Your paper guideline also serves as a resource as you build to make sure your content is accurate and clear.

When reviewing your paper guidelines, take note of which questions and answers would guide the user to move through the ALGO. See where you can add clarifying information (in the form of info boxes) along the way. Think of it as a recipe, or breaking apart the algorithm into steps.

Starting a New AvoMD ALGO

After creating your account, you will see the home page of AvoBuilder, shown below.

This is your Home page where all ALGOs that you and your collaborators create will live. To create a new ALGO (whether it is your first or your hundredth), you can click the green “Create” button in the top right of the screen.

After clicking “Create,” you will see a pop-up window asking which type of module you want to create. ALGOs ****are the most similar to virtual consults and use back-and-forth questioning to provide important clinical information. This guide covers the fundamentals of building a strong and easy-to-use ALGO.

When you see the pop-up on the right, select ALGO**.**

Title Matters: Choose Wisely

Why Titles are Crucial

The first step in creating an ALGO is to give it a title. Choosing the right title is important for a few reasons:

(1) The title of an ALGO defines the scope of what you want the user to accomplish.

• Are you helping with diagnosis, management, or both?
• Is this for use during initial medication management, or anywhere in the care timeline?

(2) More importantly, the title serves as an “anchor” to help clinical users understand that an ALGO is relevant to their case or patient.