medic / cht-docs

Documentation site for the Community Health Tookit
https://docs.communityhealthtoolkit.org
13 stars 18 forks source link

Impact monitoring documentation (brainstorm to be broken out into separate issues) #63

Open MaxDiz opened 4 years ago

MaxDiz commented 4 years ago

Impact monitoring is a core feature set that we offer CHT users. It is currently not well documented, and needs additional information on:

Existing documentation resources to reference:

This is a large body of work that we may want to split into pieces, but it would be helpful to first look at it comprehensively. We may also want to take into consideration upcoming product improvements related to transitioning away from Klipfolio.

helizabetholsen commented 4 years ago

Thanks @MaxDiz. The current plan right now is to build out our Impact Monitoring documentation in alignment with our metrics consolidation work - and data use engagement with our partners (both Medic hosted and self-hosted).

I think the flow of this documentation should include the following sections:

What is Impact Monitoring? (high level overview)

Technical Details (overview)

Data Interpretation (overview)

Screen Shot 2020-06-04 at 6 57 31 AM

The graphic above is a more up to date visual of our current data flows. I think we should consider including this in the "Data Flow" section linked above.

The "data interpretation best practices" deck is not intended for external audiences at this time but I think we could build that out - or add those content into another resource. The following resources can inform our documentation for Impact Monitoring:

helizabetholsen commented 4 years ago

We also have specific documentation for our impact monitoring priority use cases in this folder: https://drive.google.com/drive/u/1/folders/1MO70BWGoUqqLkWJwMjaRxb8XDZ1uw_jV

Here are a couple of examples:

helizabetholsen commented 4 years ago

Impact Metrics guide included in docs site #100

helizabetholsen commented 4 years ago

Hi all. I also think as we consider Impact Monitoring & Analytics Documentation, there are some broader questions to consider: