Skip to content

Commit

Permalink
feat: add training cards for More Options menu (#997)
Browse files Browse the repository at this point in the history
Adding training cards resources to docs.
---------

Co-authored-by: Michael Kohn <michael@medicmobile.org>
  • Loading branch information
latin-panda and michaelkohn committed Apr 10, 2023
1 parent 4938b3e commit 3118ffe
Show file tree
Hide file tree
Showing 9 changed files with 138 additions and 1 deletion.
3 changes: 2 additions & 1 deletion content/en/apps/features/training/_index.md
Expand Up @@ -6,13 +6,14 @@ description: >
keyword: training
relatedContent: >
apps/guides/training/training-cards
apps/guides/training/training-cards-resources
apps/examples/training
apps/examples/learning-care/
---

*Training Cards* help health workers learn about changes to CHT apps remotely, directly in their app. Training content might include information about a newly deployed feature, changes to a [care guide]({{< relref "apps/concepts/care-guides" >}}), or simply a reminder about an underused feature or workflow. They are perfect for training on a very specific topic and are not meant to replace a comprehensive onboarding program.

Template training content for new CHT features is made available from time to time. These templates can be customized to the local context.
[Template training content]({{< relref "apps/guides/training/training-cards-resources" >}}) for new CHT features is made available from time to time. These templates can be customized to the local context.

{{< figure src="training-deck.png" link="training-deck.png" class="col-12 col-lg-10" >}}

Expand Down
25 changes: 25 additions & 0 deletions content/en/apps/guides/training/training-cards-resources/_index.md
@@ -0,0 +1,25 @@
---
title: "Training Cards Resources"
linkTitle: "Training Cards Resources"
weight: 15
description: >
Training cards for CHT
keyword: training
relatedContent: >
apps/features/training
apps/guides/training/training-cards
---

This is a list of [trainings cards]({{< relref "apps/features/training" >}}) that you can use in your project to train users about new updates in CHT. Read the [step by step guide]({{< relref "apps/guides/training/training-cards" >}}) to deploy the training cards.

## More Options Menu

_Introduced in 4.2.0_

The Edit, Delete and Export actions have been moved to the More Options menu. Use this training to introduce the change to your users.

Get the training card files [here](https://github.com/medic/cht-docs/tree/main/content/en/apps/guides/training/training-cards-resources/available-trainings/more-options).

{{< figure src="images/more-options.png" class="left col-10" >}}

<br clear="all">
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
@@ -0,0 +1,8 @@
{
"title": "",
"context": {
"start_date": "2023-03-20",
"duration": 300,
"user_roles": [ "chw" ]
}
}
Binary file not shown.
@@ -0,0 +1,100 @@
<?xml version="1.0"?>
<h:html xmlns="http://www.w3.org/2002/xforms" xmlns:h="http://www.w3.org/1999/xhtml" xmlns:ev="http://www.w3.org/2001/xml-events" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:jr="http://openrosa.org/javarosa" xmlns:orx="http://openrosa.org/xforms">
<h:head>
<h:title>training:ui_change_more_options</h:title>
<model>
<itext>
<translation lang="en">
<text id="/ui_change_more_options/change_1/change_1_txt_1:label">
<value>**Edit** and **Delete** have been moved.</value>
</text>
<text id="/ui_change_more_options/change_1/change_1_txt_2:label">
<value>In the old app, you accessed these at the bottom.</value>
<value form="image">jr://images/old_actions.png</value>
</text>
<text id="/ui_change_more_options/change_2/change_2_txt_1:label">
<value>In the new app, you will tap on the three dots "**⋮**"</value>
<value form="image">jr://images/new_actions.png</value>
</text>
<text id="/ui_change_more_options/ending/ending_txt_1:label">
<value>If you do not understand these changes, please contact your supervisor.</value>
</text>
<text id="/ui_change_more_options/ending/ending_txt_2:label">
<value>When you're ready, tap on **Submit** to start using your app.</value>
</text>
<text id="/ui_change_more_options/intro/intro_txt_1:label">
<value>There have been some changes to your app, tap **Next** to review them now.</value>
</text>
<text id="/ui_change_more_options/intro/intro_txt_2:label">
<value>If you do not have time to review now, close this window and you will be reminded again later.</value>
</text>
</translation>
</itext>
<instance>
<ui_change_more_options id="training:ui_change_more_options" prefix="J1!training:ui_change_more_options!" delimiter="#" version="1 (2022-07-20 14:28:16)">
<intro>
<intro_txt_1/>
<intro_txt_2/>
</intro>
<change_1>
<change_1_txt_1/>
<change_1_txt_2/>
</change_1>
<change_2>
<change_2_txt_1/>
</change_2>
<ending>
<ending_txt_1/>
<ending_txt_2/>
</ending>
<meta tag="hidden">
<instanceID/>
</meta>
</ui_change_more_options>
</instance>
<bind nodeset="/ui_change_more_options/intro" required="false()"/>
<bind nodeset="/ui_change_more_options/intro/intro_txt_1" readonly="true()" type="string" required="false()"/>
<bind nodeset="/ui_change_more_options/intro/intro_txt_2" readonly="true()" type="string" required="false()"/>
<bind nodeset="/ui_change_more_options/change_1" required="false()"/>
<bind nodeset="/ui_change_more_options/change_1/change_1_txt_1" readonly="true()" type="string" required="false()"/>
<bind nodeset="/ui_change_more_options/change_1/change_1_txt_2" readonly="true()" type="string" required="false()"/>
<bind nodeset="/ui_change_more_options/change_2" required="false()"/>
<bind nodeset="/ui_change_more_options/change_2/change_2_txt_1" readonly="true()" type="string" required="false()"/>
<bind nodeset="/ui_change_more_options/ending" required="false()"/>
<bind nodeset="/ui_change_more_options/ending/ending_txt_1" readonly="true()" type="string" required="false()"/>
<bind nodeset="/ui_change_more_options/ending/ending_txt_2" readonly="true()" type="string" required="false()"/>
<bind nodeset="/ui_change_more_options/meta/instanceID" type="string" readonly="true()" calculate="concat('uuid:', uuid())"/>
</model>
</h:head>
<h:body class="pages">
<group appearance="field-list" ref="/ui_change_more_options/intro">
<input ref="/ui_change_more_options/intro/intro_txt_1">
<label ref="jr:itext('/ui_change_more_options/intro/intro_txt_1:label')"/>
</input>
<input ref="/ui_change_more_options/intro/intro_txt_2">
<label ref="jr:itext('/ui_change_more_options/intro/intro_txt_2:label')"/>
</input>
</group>
<group appearance="field-list" ref="/ui_change_more_options/change_1">
<input ref="/ui_change_more_options/change_1/change_1_txt_1">
<label ref="jr:itext('/ui_change_more_options/change_1/change_1_txt_1:label')"/>
</input>
<input ref="/ui_change_more_options/change_1/change_1_txt_2">
<label ref="jr:itext('/ui_change_more_options/change_1/change_1_txt_2:label')"/>
</input>
</group>
<group appearance="field-list" ref="/ui_change_more_options/change_2">
<input ref="/ui_change_more_options/change_2/change_2_txt_1">
<label ref="jr:itext('/ui_change_more_options/change_2/change_2_txt_1:label')"/>
</input>
</group>
<group appearance="field-list" ref="/ui_change_more_options/ending">
<input ref="/ui_change_more_options/ending/ending_txt_1">
<label ref="jr:itext('/ui_change_more_options/ending/ending_txt_1:label')"/>
</input>
<input ref="/ui_change_more_options/ending/ending_txt_2">
<label ref="jr:itext('/ui_change_more_options/ending/ending_txt_2:label')"/>
</input>
</group>
</h:body>
</h:html>
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 3 additions & 0 deletions content/en/apps/guides/training/training-cards/_index.md
Expand Up @@ -7,13 +7,16 @@ description: >
keyword: training
relatedContent: >
apps/features/training
apps/guides/training/training-cards-resources/
apps/examples/training
apps/examples/learning-care/
---
_Introduced in 4.2.0_

[Training Cards]({{< relref "apps/features/training" >}}) enable remote training from within the CHT by showing a sequence of "cards" containing content provided by App Developers. The content might include information about a newly deployed feature, changes to a [care guide]({{< relref "apps/concepts/care-guides" >}}), or simply a reminder about an underused feature or workflow. Enketo forms are used to display the content, and App Developers can specify a start date, duration, and to which [user roles]({{< relref "apps/reference/app-settings/user-roles" >}}) the cards should be shown. Like [app forms]({{< relref "apps/reference/forms/app" >}}), forms used by training cards will automatically be downloaded to the user’s devices.

{{% alert title="Note" %}} Example training forms are available [here]({{< relref "apps/guides/training/training-cards-resources" >}}) and provide a good starting point. {{% /alert %}}

# Step 1: Create the training form

Create an [XLS Form]({{< relref "apps/reference/forms/app#xlsform" >}}). In the following example, the training form is called `my_new_feature`, it has some text in the `label::en` column, and some images in the column `media::images` to illustrate the feature.
Expand Down

0 comments on commit 3118ffe

Please sign in to comment.