Welcome to the global DHIS2 Community of Practice (CoP)! :waving_hand:

This is the place to connect with the global DHIS2 Community, contribute with your feedback and insights as well as enhance your DHIS2 learning journey by sharing experiences and asking questions.

If you’re in a hurry, please check-out the ‘quick guide’ below, and then when you have a minute you can have a look at the ‘in-depth exploration of the forum’.

Quick Guide :

Here’s how to quickly get started and benefit from the CoP:

  1. :raising_hands: If you’ve already created an account, make sure to login. Logged in members get more features including notifications, bookmarks, improved search as well as profile stats such as ‘read-time’ tracking and automated badges. For example, if you’re logged in, you will receive the “[Read Guidelines]” badge for reading this guide!**
  2. :love_letter: If you’ve not created an account, you are welcome to join the community, click here.
  3. :smiling_face_with_three_hearts: Introduce Yourself - we’re always happy to see introductions from around the world, and would love to hear about your DHIS2 journey click here :heart:
  4. :blue_heart: Update your profile settings such as profile picture, bio, and notification settings for the categories that interest you, click here.
  5. :pray: When asking for support please provide as much information as possible such as DHIS2 version, errors logs…etc). For a detailed guide, check out “Best Practices for Support Requests” below.
  6. :trophy: Check out the copmonthly post and participate in the DHIS2 Challenge this month to receive a badge. Click copmonthly.

Whether you’re a DHIS2 Implementer, Developer, or User in the DHIS2 Community, we’ve customized the detailed walkthrough guide so it contains everything you need to know.


In-depth Exploration of the Forum :tada:

Whether you’re new to DHIS2 or already a DHIS2 expert, this in-depth exploration of some of the most important aspects of this online forum is meant to be a helpful asset for all.

We are thrilled to see community members benefiting from this guide, and looking forward to your active participation. The CoP is the biggest online DHIS2 knowledge base with tools to find, search, and contribute to existing discussions, solutions, and updates; additionally, with these easy to use tools, members can easily ask for support, report bug issues, and discuss features.

Furthermore, it is the main platform used to connect the entire DHIS2 Community with the global DHIS2 Software Core Team and the HISP Network by sharing DHIS2 announcements, innovations, and success stories. It is our aim to keep this online community accessible and helpful for all.

This walkthrough guide explores the following topics (click on each section to expand):

  • Forum Components
  • Membership
  • Forum Best Practices
  • Resources and FAQs

Forum Components

Using Forum Components: Categories, Tags, Topics, Notifications, and Key Interface Elements

Categories

Learn more about Categories and which category to use for your topic

The main CoP homepage shows the list of categories in the community. Each category is for discussions on topics related to a general area of work with DHIS2, such as “Implementation,” “Research,” or “Development.”
Categories can also include subcategories for discussing more specific topics, such as “Malaria” (in the “Implementation” category) or “SDK - Android Development” (in the “Development” category).
Posting in the appropriate category and subcategory is important for two reasons: it helps keep discussion topics organized and easier to find, and it sends notifications to other users interested in that specific topic, which makes it more likely that you will get a response.

Here’s a brief overview of the sites main and subcategories:

  1. Connect - Connectez-vous : Use this category to connect with others! Start with the Introduce Yourself topic and post your CV in the #marketplace (or announce a position).
  2. Announcements - Annonces : shares DHIS2 announcements with the entire community. Only topics approved by staff are posted here.
  3. Implementation - Implémentation : how are you and others implementing DHIS2?
  4. Support - Assistance technique : what are the challenges you or others are facing? Get support or help the community.
  5. Development - Développement : everything to do with software and app development.
  6. Server Administration - Administration-du-Serveur : for all server and hosting related discussions.
  7. Capacity building - Renforcement de capacités : resources for learning and training DHIS2.
  8. Research - Recherches : share and find DHIS2 research and connect with DHIS2 researchers.
  9. Resources - Ressources : share and find DHIS2 resources as well as FAQs.
  10. Translation - Traduction : all topics and questions related to translation of DHIS2.

If you are not 100% sure which category to post in, pick the one that seems like the best fit for your topic. The CoP moderators will move your topic to the correct category if necessary.


Tags

Learn about the most popular tags and how tags are used

When creating a topic, in addition to selecting the category, it’s possible to add a tag. Tags are keywords attached to topic posts which help identify the topic as well as send notifications to members watching this tag.

Here are some of the most popular tags and when to use them:

  1. dhis2-security : used only by the dhis2-security team to send important security updates and notifications.
  2. patch-releases : used only by the dhis2 team to post patch-release announcements and release notes.
  3. copmonthly : our community monthly post.
  4. android : use this tag for android/mobile topics.
  5. server-admin : use this tag for server related topics.
  6. tracker : tracker related topics such as program rules, program indicators…etc.
  7. analytics : related to analytics such as visualizations, dashboard…etc
  8. aggregate : for topics related to aggregate such as the data entry app.
  9. education : for topics related to EMIS and education
  10. api : API topics such as api queries, import/export through api, using the api…etc

Topics

Discussion threads on the CoP are called “topics.” When posting, there are two options: create a new topic, or post in an existing topic thread.

Here are some pointers when posting a topic:

  • If you’re not sure, create a new topic. Eventually, similar topics are merged. However, please avoid duplicating posts because duplicates get deleted. :cross_mark:
  • Please use the search engine and spend some time reading the related topic threads. If community members are already talking about it, it’s better to reply and engage in the conversation. :raising_hands:
  • You’ll find a list of suggested topics in the editor pane. Please double check you’re not duplicating a topic. :face_with_monocle:
  • If the existing topic is created in 2019 or before, it’s better to create a new topic post. :left_speech_bubble:

Additionally, you can check out our guide on Creating a New Topic


Notifications (for Categories, Tags and Topics)

Types of notifications and how to configure them and the sidebar

You can choose which topics you want to receive notifications for (or mute those you’re not interested in) through the Tracking settings in your preferences, click here.

These are the different tracking levels:

  1. :eyes: Watching: notification for every new topic and post
  2. :1234: Tracked: notification for new topics only (count posts)
  3. :one: Watching first post: notification for new topics only (not the replies)
  4. :zipper_mouth_face: Muted: you can choose to mute some topics and not receive notifications

Additionally, you can use the sidebar for further organization and navigation, check out this guide: New sidebar feature in the DHIS2 Community forum: navigate quickly and easily!


Key Interface Elements

Learn about Navigation, Search bar, Profile Preferences, Logging in to the CoP, and Invitations
1. Navigation:

Navigate the user interface efficiently using the header and sidebar.
Header: Header


Sidebar: Sidebar to check out the guide on how to customize the sidebar, click here.

2. Search bar:

one of the most important tools in the discussion forum is the Search bar. Check out the ‘Finding Information’ section for tips on how to use it.

Searchbar

3. Top Navigation Bar:

At the top of the discussion bar, we’ve added a global navigation bar for easy navigation across important DHIS2 resources: the main DHIS2.org website; Documentation; Developers Portal site; DHIS2 Demo instances; Apps Hub; and the Online Academy website.

Top Navigation Bar

4. Profile Preferences:

In addition to uploading your profile picture, members can add ‘about me’ description, Location, Web Site, Profile Header and User Card background as well as other features, click here to view your profile preferences.

Profile Preferences

5. Logging into the CoP:

Make sure you are logged in when navigating the community to improve your user stats. You can login using email/username and password, ‘Sign in with Google or LinkedIn’, or you can enter your email and select ‘skip the password; email me a login link.’

Logging into the CoP

6. Invitations:

invites are restricted to trust level 2 members and when people accept your invitations you receive badges. To invite people, either use the Invite button at the top of the sidebar, or click on the ‘Share’ button under a topic then select ‘invite’. Invitees are automatically promoted to trust level 1.

Invites Sidebar




Invites Topic


Membership

Understand how to earn more forum permissions and increase your trust level as well as how to showcase your profile using user cards and badges.

Learn about trust levels, user cards, and badges

Becoming a Community Member

A great aspect of the community is that your participation and contributions are accounted for and displayed in your profile, user dashboard, and the copmonthly post.

Learn more about Trust Levels and Permissions

Additionally, when joining the forum, members go through stages of trust levels to keep the forum safe as well as promote engagement. The higher a trust level, the more forum permissions you have. Trust levels range from 0 - 3:

  1. :hourglass_not_done: New users: trust level is by default 0 to avoid spam so please don’t keep your account at this level because the system eventually deletes accounts that remain at 0 for a long period of time.
  2. :glowing_star: Basic user: trust level 1, get here by entering at least 5 topics, reading at least 30 posts, and spend a total of 10 minutes reading posts.
  3. :glowing_star::glowing_star: Regular Member: trust level 2, get here by visiting at least 15 days, 2 likes (one given and one received), replying to at least 3 different topics, entering at least 20 topics, reading at least 100 posts, spend a total of 60 minutes reading posts.
  4. :glowing_star::glowing_star::glowing_star: Member: trust level 3, get here by within every 100 days, must have visited at least 50% of days, must have replied to at least 10 different non-PM topics, of topics created in the last 100 days, must have viewed 25% (capped at 500), of posts created in the last 100 days, must have read 25% (capped at 20k), must have received 20 likes, and given 30 likes.

You will receive a list of new permissions as soon as you are promoted to a trust level.


Represent!

When engaging with the DHIS2 Community, you want your profile to be presentable.

Here are some tips that will help make your profile unique and special…

Learn about User Cards and Community Badges

User Cards: User cards appear when a profile picture is clicked and it’s a summary of your profile with your custom design.

UserCard

You can use the following template to design your user card: Use Canva or [download ZIP User-card-resources (remove.zip from extension).zip.pdf]

Badges:
Badges are like special souvenirs that members collect across their DHIS2 journey. Yes, they’re a nice and special decoration in the profile, but they also provide more value and strength to your profile.

Badges

Some badges are granted automatically by the system based on the activity, and some are rewards granted for participation. You can check out all the badges and read their descriptions: DHIS2 Community Badges


Forum Best Practices

Learn about the best practices for engaging with the community and contributing effectively.

Learn about using the search bar, search tips, and how to reach out when you need help

Finding Information

Utilize the basic search features to find information quickly and efficiently. Making use of the search engine in the forum will save you time and help you find the information you are looking for before deciding to create a new topic.

Here are a few tips when using the search engine:

  1. The top search bar: use this bar for quick searches including:
    • To find posts by specific members, type @ then the username followed by the keywords.
    • To navigate to a person’s profile, type @ then the username and click on the username.
    • Enter keywords to see a list of suggested topics.
  2. Advanced search: in the search bar use Ctrl+Enter or click the icon to enter the advanced search page.

Search tips:

  1. Update the Posted date to limit the results to a certain period.
  2. You can find posts posted by certain members by searching for them in the ‘Posted By’ field. You can also use group:groupname to find posts by an entire group. For example, group:dhis2-core-team to find posts by the DHIS2 Core Team
  3. If you’re looking for a post that you’re 100% sure you’ve read, select the “I read” and if you posted as well as read, select the “I posted in”. You can find these options under Only return topics/posts…

Reach out: if you’re finding difficulty using the forum you can reach out to us by email (community@dhis2.org) or even better if you can post to the
Connect - Connectez-vous > Forum Feedback - Forum category then please go ahead.

:folded_hands: Avoid Direct Messages unless asked to. This forum is supposed to be inclusive and that support eventually becomes the benefit for the entire community. We’re all here to learn with and help each other! :heart:


Purposeful Engagement

We understand that everyone is occupied with their work and projects, and we’d like to make sure that everyone has the chance to participate in the community no matter how busy they are.

Learn how to make your engagement more purposeful even when asking for support:

We would like the engagement to be for the benefit of all and for this reason, we’re always happy to listen to your needs and work with you in making the community a purposeful and productive place. Make sure to review the notifications settings in your profile as explained above.

Here are some notification settings suggestions for different roles:

  1. Developers:

    • Make sure to track the Development category and tags such as API.
    • Join the Developers Monthly Meetups: Topics tagged meetup
  2. Server Administrators:

  1. Implementers:
    • Check out the subcategories in the Implementation category and track them.
    • Webinars are announced in the Announcement category, and you can always reply with your insights, feedback, and questions.

  1. Online Academy Learners:

    • Make sure to use the invitation link to join the discussion forum related to your course
    • Check out the “Introducing the DHIS2 Community of Practice discussion forum” unit in the first module
  2. Researchers:

  1. Organizations:
    • Make sure you complete your profile to represent your organization in this global community, and please keep it monitored.
    • Kindly invite your team members to the community.

  1. Asking for support:
    • When asking for support please follow the guide below.
    • Sometimes people ask for support and eventually find the solutions on their own. It means a lot to keep us updated by posting the solution.
    • Please remember to mark the post as solved when a member solves the issue.

Asking for Support

Learn how to ask for support effectively, share progress updates, and mark solutions. There are two main kinds of support topics: technical support questions and implementation questions.

Detailed instructions that will help you get better and quicker solutions when asking for support:

Here are some tips and what to include in each topic:

1. Technical Support Questions:
    • Post in the Support - Assistance technique category
    • Versions: version of the DHIS2 instance and App version
    • Platform: is this issue happening in the web or Android capture app?
    • Authority: is this issue happening to users with ALL authority? Which authorities are given to the user?
    • Reproduction: if you can reproduce the issue in any of the play.dhis2.org instances, please share the steps to reproduce
    • Test first in your browser’s Guest mode to make sure it’s not a cache issue:
      1. Open the Network and Console tabs (F12 → Network)
      2. Reproduce the issue in Guest mode
      3. Check if any errors appear in the Network or Console during the reproduction
      4. Copy the error logs
      5. If this is a server related issue:
        1. Please share the entire Catalina.out log (without the sensitive/authentication information)
        2. Post in the Server Administration - Administration-du-Serveur category or use the ‘server-admin’ tag
    • Screenshots: screenshots of the entire window helps in understanding the issue faster as well as understanding the issue is.
Implementation Questions:
  1. Post in the Implementation - Implémentation category
  2. The most important question in implementation questions is: “what is the use case?”
    providing a closer picture at what you’re trying to achieve helps in finding the solution. Sometimes there is more than one way to achieve the same result and experts are able to suggest helpful workarounds when the purpose is clear.
  3. Is this a bug?
    A bug is when something is already expected to work but it isn’t working the way it should, so we’re happy to find and triage bugs, and in this case please use the ‘Technical Questions’ guide above to provide the necessary information.
  4. Is this a feature request?
    Feature requests come all the time from the community and some are helpful suggestions. It’s important when discussing a feature request to explain why this is important for your use case, and keep the community as a whole in mind because it’s more likely to become implemented if more community members add their input and vote.

Resources and FAQs

Frequently Asked Questions

Find answers to common queries, such as how to create feature requests, where to access DHIS2 demo servers, and how to join events.

FAQ
When to create a feature request or bug ticket? And how?
         After creating a new topic and discussing the issue you are facing, if it turns out to be a bug issue because something is expected to work in a certain way but it's not working as expected. You will be requested by one of the moderators to create a bug issue ticket in jira.dhis2.org. Refer to [Asking for Support](#Asking for Support) above for further details about what info to include.
          You will be asked to share the link to the ticket in the CoP posts so other community members can watch to receive notifications when there are updates.
Where can I access DHIS2 demo servers for practice?
   Please use play.dhis2.org 
My question isn’t in the documentation. Where can I find help?
   You're in the right place. Please post in the [DHIS2 Community of Practice](community.dhis2.org)!  
I can contribute to the documentation, how can I help?
   If there's a issue, it might be a good idea to discuss in the CoP by creating a topic post, and then you can always contribute to the docs by creating a pull request through GitHub. Click on the 'pencil' :pencil: icon at the top of a docs page. 

Should I post in the CoP or ask the AI instead?
You're always welcome to post to the CoP! You can save time by asking the AI in docs.dhis2.org and it could be very helpful since it also references forum posts that have been solved and posts from the core team. If the AI doesn't cover your question, or if you'd like to have a direct interaction with the community members, you can post to the community. You could start by using the AI to learn more about a topic and then curate a new topic post for further discussion. When you create a topic post in the CoP, it is helpful for everyone to benefit from the discussion, and it makes it easier to triage if there's a bug issue or a feature request. Finally, remember that every minute in the CoP counts and is added to your profile stats as a DHIS2 Community Member.
How do I join the Online Academy Course discussion forums?
 DHIS2 Online Academy learners have a private space for each digital course where they can join discussions about the topics they are learning. You can find instructions in the unit "Introducing the DHIS2 Community of Practice discussion forum" in the first module.
How do I accept an invitation link?
 If you received an invitation link, after you click on it, if you're an existing user then simply login; however, if you're new to the forum then please sign up.
How can I join a DHIS2 event?
 When a DHIS2 event is announced in the CoP there will be instructions on how to join. If there's a zoom meeting access, you will be provided with a link. You can always reply to the post and ask if there's anything not clear.
What is the #CoPMonthly post, and how do I get involved?
 The #CoPMonthly post is the post where we mention the most important highlights in the forum during the month, new and upcoming things to keep an eye for, and most importantly tag the helpful and active members in the community. There's a special DHIS2 Challenge each month where participants are awarded the CoP Activity Winner badge.
I’ve posted my issue but still didn’t find a solution. What’s next?
If we're still not able to find a solution after discussing the issue in the forum, moderators triage the issue to the DHIS2 Core Team. If the post needs follow-up, feel free to tag (@gassim or @moderators).
I want to reach out to the DHIS2 Core Team directly. How?
While posting to the online forum is for the benefit for the entire community, we understand that some requests are specific. Please see 'General inquiries for the core team' in the [Contact Us](https://dhis2.org/contact/) page.
What if I’m facing an emergency issue?
For security issues, please reach out to the @dhis2-security team by sending an email to: (security@dhis2.org). 

For other issues, please send an email to post@dhis2.org


:rocket: Check out our resources and get involved in various activities to enhance your experience in the CoP.