-
Notifications
You must be signed in to change notification settings - Fork 9
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
Suggested changes #109
Open
alessandraSPB
wants to merge
4
commits into
main
Choose a base branch
from
suggested-changes
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Suggested changes #109
Changes from all commits
Commits
Show all changes
4 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -12,8 +12,8 @@ This repository is the first stop for open source communities wishing to contrib | |
To participate as a community member: | ||
|
||
1. Sign in with your GitHub account. | ||
2. Go to the [discussions](https://github.com/WorldHealthOrganization/open-source-communication-channel/discussions) page. | ||
3. Pick a category and start a discussion. | ||
2. Go to the [issues](https://github.com/WorldHealthOrganization/open-source-communication-channel/issues) page. | ||
3. Propose an issue. | ||
|
||
### 🤔 When do I use this? | ||
|
||
|
@@ -50,22 +50,20 @@ Please follow this [Contributor Guideline](CONTRIBUTING.md) when planning to col | |
|
||
The [Starting an Open Source Project Guide](docs/guidance/starting_open_source_project.md) is a good starting point for project teams working with WHO and want to start an open source project or open source an existing project. | ||
|
||
### Roadmaps | ||
|
||
- [OSPO Roadmap](https://github.com/WorldHealthOrganization/open-source-communication-channel/projects/3) | ||
|
||
### Current projects | ||
|
||
Please, stay tuned while we work on sharing repositories for open source collaboration. | ||
|
||
### 👥 Our team | ||
|
||
The following folks are the maintainers for this repository. Please feel free to contact them via an [@mention](https://docs.github.com/github/writing-on-github/basic-writing-and-formatting-syntax#mentioning-people-and-teams) in an [issue](https://github.com/WorldHealthOrganization/open-source-communication-channel/issues/new), or via email for any questions, comments, and/or ideas you may have relating to WHO's Open Source initiative and this repository: | ||
You can contact the OSPO team at [email protected]. The following folks are the maintainers for this repository. Please feel free to contact them via an [@mention](https://docs.github.com/github/writing-on-github/basic-writing-and-formatting-syntax#mentioning-people-and-teams) in an [issue](https://github.com/WorldHealthOrganization/open-source-communication-channel/issues/new), or via email for any questions, comments, and/or ideas you may have relating to WHO's Open Source initiative and this repository: | ||
|
||
| Name | Contact | Pic | ||
| -------------- | ---------- | ----------------------------- | ||
| Samuel Mbuthia | [@smbuthia](https://github.com/smbuthia) | <img src="https://avatars.githubusercontent.com/smbuthia?s=100" width="100" /> | ||
| Catharina Maracke | [@catharinamaracke](https://github.com/catharinamaracke) | <img src="https://avatars.githubusercontent.com/catharinamaracke?s=100" width="100" /> | ||
| Alessandra D'Angelo | [@alessandraSPB](https://github.com/alessandraSPB) | <img src="https://avatars.githubusercontent.com/alessandraSPB?s=100" width="100" /> | ||
|
||
|
||
💖 To help make this a welcoming and inclusive community, please read our [code of conduct](https://github.com/WorldHealthOrganization/open-source-communication-channel/blob/main/CODE_OF_CONDUCT.md). | ||
|
||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -4,7 +4,7 @@ | |
|
||
Open source communities are made up of users, contributors, and maintainers. | ||
|
||
> 📖 **Read more:** [The Open Source Contributor Funnel](https://mikemcquaid.com/the-open-source-contributor-funnel-why-people-dont-contribute-to-your-open-source-project/) | ||
> 📖 **Read more:** [Growing Your Contributors](https://docs.oscollective.org/guides/growing-your-contributors) | ||
|
||
- *Users* are those who use the software but are not submitting code or documentation. The may sometimes submit support issues. | ||
- *Contributors* are those who are submitting code or documentation but need someone to review their code and merge their contribution. They do not have permission to merge their own changes. | ||
|
@@ -39,4 +39,4 @@ Have the following in place as you set up your community: | |
|
||
## 💬 How the Open Source Programme Office Can Support Your Work | ||
|
||
If you have questions, would like to make an existing project open source, or start a new project that you would like to be open source, please reach out on [Discussions](https://github.com/WorldHealthOrganization/open-source-communication-channel/discussions). | ||
If you have questions, would like to make an existing project open source, or start a new project that you would like to be open source, please reach out at [email protected] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change | ||||
---|---|---|---|---|---|---|
|
@@ -10,9 +10,11 @@ Keeping your community engaged is important if you want to keep contributions co | |||||
|
||||||
There are many options to choose from when it comes to community platforms. Two recommended platforms are: | ||||||
|
||||||
- [GitHub Discussions](https://docs.github.com/en/discussions) takes the least effort to setup if your project repository is on GitHub. | ||||||
- [Discourse](https://www.discourse.org/) is an open source platform that provides various features for community discussions and tools for moderation. | ||||||
- [GitHub Discussions](https://docs.github.com/en/discussions) takes the least effort to setup if your project repository is on GitHub.However, according to users GitHub is mainly used for technical developments rather than as a forum. | ||||||
- [Discourse](https://www.discourse.org/) is an open source platform that provides various features for community discussions and tools for moderation. WHO has been using Discourse for several internal and external projects. | ||||||
|
||||||
- Before selecting a platform, it is important to check whether the users that we are planning on engaging are already members of an existing community in order to avoid duplications and, when possible, maintain the same platform where users are already familiar. In all cases, the selected platform should be user-friendly and compliant with data privacy and protection rules for WHO. | ||||||
- | ||||||
> ℹ **Note:** For WHO projects, reach out to the WHO OSPO or IMT if you would like support setting up your community platform. | ||||||
|
||||||
### Managing your Community Platform | ||||||
|
@@ -25,6 +27,19 @@ Your community needs to be a safe, inclusive, and inviting space for everyone to | |||||
- help keep the community platform well organized to make it easy for people to use, for example, by maintaining a clear list of discussion categories and provide guidance on how to post | ||||||
- promote engagement on the community platform by encouraging people to post or by posting what they have heard from people | ||||||
|
||||||
Before openining a community, the community manager should ensure that there is content planning covering at least the initial month of community's activity. | ||||||
|
||||||
### Evaluating your community | ||||||
|
||||||
It is important to set metrics and indicators to evaluate your community's success over time. | ||||||
|
||||||
Metrics and indicators can refer to the purpose why the community has been built, and to how healthy and alive the community is. In both cases, an ongoing evaluation of your community is a useful exercise to understand whether there is a need to maintain the community, whether the invested resources are appropriate, and whether the users are getting a significant value from participating. | ||||||
|
||||||
Metrics can include quantitative data generated by the system, such as pages visited, time spent over articles, number of users, active users, new posts etc. For complex Organizations such as WHO, however, it is recommended that the evaluation is also complemented by qualitative data and feedback. This will include users interviews, surveys, discussions, and qualitative analysys of trends. | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
|
||||||
An examples of metrics adopted by WHO Open Source Projects is [here](https://worldhealthorganization.github.io/world-health-org-metrics). | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
|
||||||
|
||||||
## 📅 Community Events | ||||||
|
||||||
Community events are a good way to drive engagement. Both in-person and online events provide an opportunity for community members to get to know one another and promote a sense belonging. | ||||||
|
@@ -40,4 +55,4 @@ Community events are a good way to drive engagement. Both in-person and online e | |||||
|
||||||
## 💬 How the Open Source Programme Office Can Support Your Work | ||||||
|
||||||
If you have questions, would like to make an existing project open source, or start a new project that you would like to be open source, please reach out on [Discussions](https://github.com/WorldHealthOrganization/open-source-communication-channel/discussions). | ||||||
If you have questions, would like to make an existing project open source, or start a new project that you would like to be open source, please reach out at [email protected] |
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.