Documentation Forum 2019-02-19

Tags: #<Tag:0x00007fdb1b533bc8>

(Juliet Wamalwa) #1

Hello all, Today’s documentation Forum is from 4pm - 5pm EAT and 1pm - 2pm UTC.


Notes: [ -Documentation-Forum]

To join the call using Audio, Chat, & Screen Sharing please use a Webster-compatible browser (Chrome recommended) and join the OpenMRS UberConference call:


UberConference - The Best Free Conference Call

UberConference provides a rich visual interface for conference calls. Simple, visual, and free to use, it’s audio conferencing done right. Easily set up and join free conference calls, see who is in the conference, who is talking, and use powerful…

The next documentation Forum will be on Tuesday, February 26th @ [4-5 pm EAT] ( - OPEN FORUM

Kindly come and share ideas on how to improve on our documentation.
cc @c.antwi, @ruhanga, @jennifer, @dkayiwa, @irenyak1,@burke, @herbert24 , @dkayiwa, @lana, @monasaleh, @odorajonathan, @georgejr, @collinewait, @gcliff and @jwnasambu

Updating 'Using OpenMRS' in the wiki

Thanks juliet for the reminder :+1:

(Juliet Wamalwa) #3

Just a reminder, documentation forum meeting will begin in 10min time.
cc @c.antwi, @ruhanga, @jennifer, @dkayiwa, @irenyak1,@burke, @herbert24 , @dkayiwa, @lana, @monasaleh, @odorajonathan, @georgejr, @collinewait, @gcliff and @jwnasambu

(Juliet Wamalwa) #4

Hello friends, kindly help help us understand the following:

  1. Difference between the implementer’s guide and the user guide.
  2. The personas each guide is supposed to address.
  3. At the end of documentation review process how many guides should openmrs have?
    Thanks in advance

cc @paul, @dkayiwa, @burke, @jeffneiman, @michael, @surangak, @ssmusoke, @ningosi, @carl, @jblaya and @ball

(Jessica Ruff) #5

Just a thought here, but I would think that the implementer’s guide is for systems admins and other who are trying to set up an instance of OpenMRS, it would include things like, this is server you will need to set up OpenMRS for your program. While the user guide is for the end user, those that will actually be using the software. So for example it might include, here’s how to register a patient in the reference app.

(Juliet Wamalwa) #6

Thanks for your feedback. Could we be having any existing user guide that you know of ?

(Jan Flowers) #7

Hi @jwnasambu and @ruffjm - The implementer’s guide would go well beyond the installation of OpenMRS, but also cover how to prepare the organization for change to use OpenMRS, what steps are needed to fully implement, and how to ensure an implementation is successful. Roles that might lead this work are an HMIS Officer, M&E Lead, Implementation Specialist, etc. These people are the ones who coordinate an implementation even if they aren’t doing all of site-level work in the implementation - readiness/site assessment, preparation, orientation/champions for change, infrastructure/hardware, training, data migration, data reconstruction, quality assurance and acceptance testing at the site level, go-live, pilot to production, and ongoing monitoring & updates. Our implementation guide needs to reflect what it takes in the real world, at a site, to implement OpenMRS. This is a big project, but a very worthy one. Do we have a starting document that we’ve created for OpenMRS in the past on this?

(Jessica Ruff) #8

I’ve been tasked with developing something similar form AMPATH, what it takes to run our version of OpenMRS. I’ve been using this as a start.

(Juliet Wamalwa) #9

This is the implementer’s guide we have so far. You haven’t talked about the user guide. In yesterday’s forum we learned that we have two guides that is developer and implementer’s guide. What is the origin of the user guide? which personas is it supposed to address? kindly help us we are stack

(Jessica Ruff) #10


I don’t know that there is a current users guide. At AMPATH we have developed some training materials for past versions, but our current method of training is to take the users through a live version of the application and then provide one the job training.

Bahmni has EXCELLENT documentation. Here is a link to their implementors guide and user guide.

(Juliet Wamalwa) #11

Thanks let me go through the links

(Cynthia Antwi) #12

+1 on @janflowers has mentioned.

Could we schedule a brief call to iron some of these issues out this week?

@jwnasambu @ruhanga

(Juliet Wamalwa) #13

True. Which day and time is convenient ?

(Cynthia Antwi) #14

Depending on who we can get we can do it early morning ? 8am UTC/11am EAT?

Tommorow or Friday Morning is still ok

(Juliet Wamalwa) #15

@c.antwi thanks so much, the earlier the better. Friends, kindly join us tomorrow at 8am UTC/11am EAT to iron out some issues on user persona. Your submission are highly welcome.

cc @c.antwi, @ruhanga, @jennifer, @dkayiwa, @irenyak1,@burke, @herbert24 , @dkayiwa, @lana, @monasaleh, @odorajonathan, @georgejr, @collinewait, @gcliff, @ruffjm, @janflowers and @jwnasambu


thanks juliet for the reminder

(Daniel Kayiwa) #17

Is this put on the OpenMRS Calendar?

(Juliet Wamalwa) #18

Its not. Only that in yesterday’s meeting we didn’t conclude on the difference between the user guide and implementer’s guide and we just wished to iron out basing on members submission on talk.

(Jan Flowers) #19

Thought this might be useful. Here’s a link to an implementer’s guide and supporting tools that we developed in eSaude for the national OpenMRS rollout in Mozambique:

(Nathan Ruhanga) #20

@c.antwi, @jwnasambu thank you for the communication.