Submit a Bug

Purpose

The Submit Bug function is used when something in the system doesn’t work as expected. Submitting a clear report helps the support team understand what went wrong and decide what can be done.

⚠️ Do not include Personal Health Information (PHI). Never type patient names, full birthdates, addresses, or take screenshots showing identifiers. Use test patients or IDs only.

A bug is any unintended behaviour — from a small display issue to a major system error. Some bugs can be fixed quickly, while others may require more time, or may not have an immediate solution. Even if no fix is available right away, reporting the bug ensures it is tracked and considered in future updates.

Navigation

From the sidebar, expand System and select Submit Bug.

How to Submit a Bug

Option 1 – From the Sidebar

  1. From the sidebar → System → Submit Bug

  2. Fill in the form:

    • Description – What happened? What should have happened instead?

    • Steps to Reproduce – The exact, click-by-click path you took.

      • Tip: Use the 4 W’s → Who, What, When, Where

        • Who: Your role (e.g., Nurse, Data Clerk)

        • What: What went wrong

        • When: Date, time, timezone

        • Where: The screen/module

  3. Press Submit once both fields are complete.

    • Device logs are attached automatically — you don’t need to upload anything.

Option 2 – From an Error Modal

Sometimes an error appears as a pop-up while you’re working.

  • Report Bug → opens the Submit Bug form with details pre-filled.

  • OK → closes the error only (does not report it).

Reporting a bug directly from an error modal automatically attaches error details, making your report more accurate and faster to process.

What Happens Next

  • Acknowledgement – Usually within 1–2 business days.

  • Triage – Support reviews and classifies (about 3–5 business days).

  • Fix – Depends on severity and release schedules:

    • Blocking issue (clinic cannot run): handled ASAP during work hours.

    • Workaround available: fixed in next update.

    • Minor/cosmetic: tracked and fixed later.

⏱ Note: There is no 24/7 coverage. Issues on weekends/holidays may wait several days for response.

Tips for Helpful Reports

  • State the screen/module (e.g., “Patient Header,” “End Session”).

  • Mention when it happened (date, time, and timezone).

  • Note your role (Nurse, Data Clerk) and device (tablet, desktop).

  • Use the 4 W’s (Who, What, When, Where).

  • Keep it short and factual.

Example (Non-PHI)

Description: The Date of Birth does not display in the patient header. This happened on the "Performing a Visit for a Child Immunization" page.

I was logged in as a Nurse using a clinic tablet.

Steps:

  1. Log in as a Nurse on a clinic tablet.

  2. From the Dashboard, search for a test patient in DemoLand.

  3. Open the patient record.

  4. Start a Child Under 5 visit.

  5. Look at the patient header. DOB missing.

PreviousLocal UsersNextBackups

Last updated