Skip to content

feat(#1828): create squad page #1859

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 33 commits into from
May 26, 2025
Merged

feat(#1828): create squad page #1859

merged 33 commits into from
May 26, 2025

Conversation

Phil-Mwago
Copy link
Contributor

@Phil-Mwago Phil-Mwago commented Apr 28, 2025

Description

Add the Community and Squad journey page on the doc site.

Closes #1828

License

The software is provided under AGPL-3.0. Contributions to this project are accepted under the same license.

@Phil-Mwago Phil-Mwago requested a review from andrablaj April 28, 2025 13:11
Copy link
Member

@andrablaj andrablaj left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for starting the discussion here, @Phil-Mwago!

I am reluctant about the need of this page. It seems like many items belong to the already existing "Getting involved" page, so maybe you can just enrich that existing page with the missing items?

The squad journey stages are also mismatching the stages you added in the parallel PR you opened today, so I suggest consolidating them on the Roadmap page to match the GitHub project stages you created.

@@ -0,0 +1,35 @@
# Join the Journey: Shape the Future Together!
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You will need to add the page headers specific to Hugo so that this page appears in the sidebar navigation. Please check other docs site pages for headers examples, something like:

---
title: "CHT Roadmap"
linkTitle: "Roadmap"
weight: 2
description: >
  CHT Initiatives
---

@@ -0,0 +1,35 @@
# Join the Journey: Shape the Future Together!

## 🌱 **Community Member Journey: Grow & Contribute**
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In general, I feel that there is an overlap between this page and the "Get involved" page. I suggest you enrich the existing page with items that are missing, such as "Want to share feedback? Participate in forums, webinars, and roundup calls."


---

## ⚡ **Squad Journey: Collaborate & Build**
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is a discrepancy between the squad stages on the roadmap and the stages you added here. I suggest we merge them and keep them consistent so the community members won't get confused.

@andrablaj
Copy link
Member

@Phil-Mwago I suggest we repurpose this PR to tackle #1750. I believe the community would benefit from understanding what a squad is, how to join one and how to form one. We can get inspired by the following resources from OpenMRS and adjust them with the CHT reality:

Let me know what you think!

@Phil-Mwago Phil-Mwago changed the title Create journey.md: member and squad Create squad.md May 22, 2025
@Phil-Mwago Phil-Mwago changed the title Create squad.md Create squad journey.md May 22, 2025
@Phil-Mwago Phil-Mwago requested a review from andrablaj May 22, 2025 11:01
@Phil-Mwago
Copy link
Contributor Author

Hi @andrablaj sounds good to me. Made some edits adding information on squads. Please review.

@Phil-Mwago Phil-Mwago requested a review from antonykhaemba May 22, 2025 11:06
@andrablaj
Copy link
Member

@Phil-Mwago I just merged the main branch into this branch, as the PR was not running locally.

Copy link
Member

@andrablaj andrablaj left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the updates, @Phil-Mwago! It makes a lot more sense to have a squad journey page.

I added some comments. mostly related to the format.

**The CHT Squad Journey**
Squads evolve through stages, and anyone can contribute—no matter their experience level. Here are the various stages:

1. **✨** Emerging
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please review the list of statuses to exactly match the squad statuses in the roadmap.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please review the list of statuses to exactly match the squad statuses in the roadmap.

Done, matched all of them.

- ✅ Partners and contributors aligned
- ✅ The [Code of Conduct](https://docs.communityhealthtoolkit.org/community/contributing/code-of-conduct/) is shared with all squad members

2. **🧑🏼‍🎨** Early Design
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
2. **🧑🏼‍🎨** Early Design
2. 🧑🏼‍🎨 Early Design

Phil-Mwago and others added 13 commits May 22, 2025 17:36
Co-authored-by: Andra Blaj <andra@medic.org>
Co-authored-by: Andra Blaj <andra@medic.org>
Co-authored-by: Andra Blaj <andra@medic.org>
Co-authored-by: Andra Blaj <andra@medic.org>
Co-authored-by: Andra Blaj <andra@medic.org>
Co-authored-by: Andra Blaj <andra@medic.org>
Co-authored-by: Andra Blaj <andra@medic.org>
Co-authored-by: Andra Blaj <andra@medic.org>
Co-authored-by: Andra Blaj <andra@medic.org>
Co-authored-by: Andra Blaj <andra@medic.org>
Co-authored-by: Andra Blaj <andra@medic.org>
@Phil-Mwago Phil-Mwago requested a review from andrablaj May 22, 2025 15:14
Copy link
Member

@andrablaj andrablaj left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Almost there! Thank you for the additions!

@andrablaj
Copy link
Member

@Phil-Mwago I just found this document that was put together a few months ago when we started the squad approach. I think has very good language about "starting a squad" and the different statuses that would be good additions to the page you put together. I can incorporate langauge in another PR after this one is merged or you can do it directly here - let me know what you prefer and how can I support.

@andrablaj andrablaj changed the title Create squad journey.md feat(#1828): create squad page May 22, 2025
@Phil-Mwago
Copy link
Contributor Author

@andrablaj sure, sounds great. I will incorporate it here today.

Phil-Mwago and others added 14 commits May 23, 2025 16:30
Co-authored-by: Andra Blaj <andra@medic.org>
Co-authored-by: Andra Blaj <andra@medic.org>
Co-authored-by: Andra Blaj <andra@medic.org>
Co-authored-by: Andra Blaj <andra@medic.org>
Co-authored-by: Andra Blaj <andra@medic.org>
Co-authored-by: Andra Blaj <andra@medic.org>
Co-authored-by: Andra Blaj <andra@medic.org>
Co-authored-by: Andra Blaj <andra@medic.org>
Co-authored-by: Andra Blaj <andra@medic.org>
Co-authored-by: Andra Blaj <andra@medic.org>
Co-authored-by: Andra Blaj <andra@medic.org>
Co-authored-by: Andra Blaj <andra@medic.org>
Co-authored-by: Andra Blaj <andra@medic.org>
@Phil-Mwago Phil-Mwago requested a review from andrablaj May 23, 2025 15:23
Copy link
Member

@andrablaj andrablaj left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the additions, @Phil-Mwago! Two small comments and we are good to go.

I still feel we could leverage more language from this doc, but let's do it in a separate PR and have this first version live soon!

Phil-Mwago and others added 2 commits May 23, 2025 21:01
Co-authored-by: Andra Blaj <andra@medic.org>
Co-authored-by: Andra Blaj <andra@medic.org>
@Phil-Mwago
Copy link
Contributor Author

@andrablaj that's fine. We can now merge.

@Phil-Mwago Phil-Mwago requested a review from andrablaj May 26, 2025 06:56
Copy link
Member

@andrablaj andrablaj left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚢

@Phil-Mwago Phil-Mwago merged commit 3cb6316 into main May 26, 2025
2 checks passed
@Phil-Mwago Phil-Mwago deleted the Add-a-journey-page branch May 26, 2025 08:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Document squad journey
2 participants