Outreachy 2022 applicants, start here!

[Angamanga]

Welcome to Ushahidi and the application-process for Outreachy!

We are so excited you are here!! 🌻 🎉 💐

There are a few steps you need to complete before starting working on an issue. These are:

1. Read through our Code of Conduct
2. Get set up and say hello in Gitter to communicate, help and get help from the community.
3. Get your developer-environment set up. We most often recommend using the Vagrant-setup, but XAMPP usually works fine too. Once you have set up your API, remember to setup the Platform-client as well! If you get stuck, reach out to the Gitter-channel to get help.

You also need to set up our bot-engine: https://github.com/ushahidi/ussd-engine. Follow the instructions in the readme to get setup!

4. Explore the Ushahidi Platform and the different concepts like surveys (also called "forms" in some places) and posts. Try setting up a survey, a few categories, and add some posts. The user-documentation is found here: https://docs.ushahidi.com/ushahidi-platform-user-manual/

5. Once you have completed steps 1-4, send a reply to this discussion with screenshots of your setup in the browser and select an issue to work with.

To keep in mind when starting working on issues:

• Good issues to work with are found here:

  • https://github.com/ushahidi/ussd-engine/labels/Outreachy2022
  • Outreachy2022

• Only work on one issue at a time. We are looking for the quality of the contributions rather than the number of contributions when evaluating the applications.

• Once you are assigned to an issue, we want you to submit a pull request within 3 days, even if it is not yet complete or a working solution. This is to make our contributors work "in the open" as is often done in Open Source and make sure no issues are not being worked on. If you don't show progress within 3 days, we will open it up for other students. Github has a good guide on how to submit pull requests from a fork: https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork

Remember
Ushahidi is an open-source community. The mentors are trying their best to reply to your questions, but there may be some delays. By helping other applicants out in Gitter, you are also helping the mentors. This is recognized by us and seen as something very positive in evaluating the applications. So if you see someone asking for help in the chat and know the answer, please help them out! Keep the tone nice and collaborative.

Privacy info/personal info
During the application-process, Ushahidi will store your Github-handle in a google-sheet. This is done only to make the application process as smooth as possible and to keep track of which issues are being worked on and the progress of each issue. The information stored will be deleted once the application-process is over.

[helen-ndip]

Hello @Angamanga I have completed steps 1-4. Below are my screenshots. I would like to work on issue #4306

1. Platform API
   

2. Platform Client
   

3. Bot-engine
   

[helen-ndip]

Hi @helen-ndip, url starting with git@github.com shows use of ssh connection, while url starting with https://github.com shows use of https connection. Sometime between August and October 2021, GitHub removed support for password authentication for when a Github user wants to perform a push or pull operation (when using https). Note: this doesn't affect cloning a repo. You can find time to read the What you need today section of this Github post: Token authentication requirements for Git operations. If you ever have the push or pull issue I described above, you can always switch to using ssh. This part of the GitHub documentation will guide you: https://docs.github.com/en/authentication/connecting-to-github-with-ssh. You can always reach out if you need help with this at any point.

very correct. I did not set up the ssh keys.

[helen-ndip]

Hi @helen-ndip, url starting with git@github.com shows use of ssh connection, while url starting with https://github.com shows use of https connection. Sometime between August and October 2021, GitHub removed support for password authentication for when a Github user wants to perform a push or pull operation (when using https). Note: this doesn't affect cloning a repo. You can find time to read the What you need to do today section of this Github post: Token authentication requirements for Git operations. If you ever have the push or pull issue I described above, you can always switch to using ssh. This part of the GitHub documentation will guide you: https://docs.github.com/en/authentication/connecting-to-github-with-ssh. You can always reach out if you need help with this at any point.

@Ifycode can we say issue 2 is a valid issue for many people though? Can I send a pull request on the docs for this?

[helen-ndip]

Hi @helen-ndip, url starting with git@github.com shows use of ssh connection, while url starting with https://github.com shows use of https connection. Sometime between August and October 2021, GitHub removed support for password authentication for when a Github user wants to perform a push or pull operation (when using https). Note: this doesn't affect cloning a repo. You can find time to read the What you need to do today section of this Github post: Token authentication requirements for Git operations. If you ever have the push or pull issue I described above, you can always switch to using ssh. This part of the GitHub documentation will guide you: https://docs.github.com/en/authentication/connecting-to-github-with-ssh. You can always reach out if you need help with this at any point.

@Ifycode can we say issue 2 is a valid issue for many people though? Can I send a pull request on the docs for this?

Also docs says node version for platform client should be higher than 10 but in actual case it should be >=10 <13.

[Angamanga]

Hi @helen-ndip, good job on setting everything up. For issue 2 you can send a pr in the docs. Thank you for noticing 🙏

[helen-ndip]

Okay I will do just that thank you.

[yuktea]

Hey @Angamanga
Done with Step 1-4! Can I begin working on Issue #4306 ?

[Angamanga]

@yuktea Good job setting up the environment. Please go ahead working on #4306

[Angamanga]

@yuktea You need to comment in the issue before I can assign you to it.

[andrew21-mch]

hi @Angamanga, sorry for sending this late, i did not notice
I have been able to fully setup my development environment
Ussd-Engine

Ushahida Client

Ushahidi-Backend

[Angamanga]

@andrew21-mch Good job 🎉

[andrew21-mch]

@Angamanga, i also noticed that while setting up the ussd-engine, some people might encounter an error when they take composer install

i recomend a
composer update
then
composer install

[Angamanga]

@andrew21-mch Thank you for the recommendation, I'll update the readme 🙏

[Saumay1]

Hello @Angamanga!!
Completed the steps:

1. Platform API (Backend)

2. Platform Client (Frontend)

3. USSD Engine

[Angamanga]

@Saumay1 Good job 🎉

[Saumay1]

Hi @Angamanga !
May I work on issue #4245.

[Angamanga]

@Saumay1 Yes, please go ahead!

[angeangoh]

hello @Angamanga I set up my local environment and make an inspection on the features. Is there any available task for me because I don't know which one has already be taken by other interns? Anyway, I would like to work on this issue #4384

[angeangoh]

Sorry to be late, I set up it for a while and forgot to come and post here.

[bkplaravel2018]

Hello @Angamanga
Done with Step 1-4! Can I start working on Issue #4152 ? Or would you give me any good-first-issues which are not assigned to other?

Backend Setup:

Client Setup:

BotMan-engine Setup:

[ps-19]

Hi,
My name Priyansh Singh .

[ps-19]

My relevant project based on Laravel framework:
Posts Complete blogging website based on PHP. PHP Version of Blogger.com website, CRUD operations.
Read, Create, Edit, Delete the Post can be performed. Authentication is also available. A user can register on website, view blogs written by authenticated users.
Read, write, modify only by author option are provided. Images and videos insertion is also supported.

[ps-19]

I have already worked on issue #4401 #4409 #4288.

PRs:
#4408
#4411
ushahidi/platform-client#1779

[ps-19]

My relevant project based on Laravel framework:
Posts Complete blogging website based on PHP. PHP Version of Blogger.com website, CRUD operations.
Read, Create, Edit, Delete the Post can be performed. Authentication is also available. A user can register on website, view blogs written by authenticated users.
Read, write, modify only by author option are provided. Images and videos insertion is also supported.

[ps-19]

@Angamanga mam please review

[ammarumer]

Hi @Angamanga I am completely new to open source and this first time that I am actually writing a comment on github after creating account which feels exciting.
My name is Ammar Umer and I am from Lahore,Pakistan albiet a small country in terms of technology and I'm outreachy applicant. For past 10 days I was completely sick with severe cough and fever and unfortunately due to which wasn't able to work on it and post earlier. And on top it took me 3 days to select project according to my preference and this was the one which I finally decided because it is close to my skillset as I have bit experience of PHP and Javascript.
I've followed your instructions and setup all the 3 directories using XAMP on windows and read the documentation as well.

Here are the setup screenshots

1. Api Backend
   

2. Api Client
   

3. USSD Engine
   There was one thing that I wasn't able to clone the ussd-engine directory with this URL git@github.com:ushahidi/ussd-engine.git
   

So I cloned with https URL and then setup the directory

I know I'm late to party but I would like to join and be part of your team and want to learn and contribute with hard work and dedication. Lastly I've browsed through the issues but mostly are taken for so I would like you to assign me any issue.

Thanks cheers

[ammarumer]

@Angamanga ma'am hope you are doing well. I would really appreciate if you could assign me an issue in which I could contribute plus learn as well. I have bit of experience in PHP so would like any task to make myself familiar with the API.