WomenWhoCode

CodePath group project. Bring the WWCode experience mobile.

Problem/Opportunity: Currently, our reach happens through expanding networks and our weekly Code Review. We want to be able to reach an engineer even if we don’t have a network in their area, more directly, and make it so they feel like they are apart of WWCode regardless of where they are in the world. Our goal is to reach 1 million engineers.

Product Overview: This experience will leverage existing internal data: WWCode events, event streaming, resources, internal blogs, job posts, inbound conference data. We will also provide the ability to connect with other like minded engineers through in app direct messaging and event driven groups.

We are going to find out what interests our members based on a personalization flow in order to feed them proper data and connect them with like minded members in their area and around the world. This is creating a more immediate, and direct way to connect regardless of where you are located.

Setup for Developers

1. Make sure you have downloaded the latest version of Android Studio. It works on Linux, Windows and Mac. Download the correct version for your OS
2. Go to the project repo and fork it by clicking "Fork"
3. If you are working on Windows, download Git Bash for Windows to get a full Unix bash with Git functionality
4. Clone the repo to your desktop git clone git@github.com:your_name/WomenWhoCode.git
5. Open the project with Android Studio

Configure remotes

When a repository is cloned, it has a default remote called origin that points to your fork on GitHub, not the original repository it was forked from. To keep track of the original repository, you should add another remote named upstream:

1. Open terminal or git bash in your local repository and type:

   git remote add upstream https://github.com/WomenWhoCode/WomenWhoCode.git

2. Run git remote -v to check the status, you should see something like the following:

origin https://github.com/YOUR_USERNAME/WomenWhoCode.git (fetch)

origin https://github.com/YOUR_USERNAME/WomenWhoCode.git (push)

upstream https://github.com/WomenWhoCode/WomenWhoCode.git (fetch)

upstream https://github.com/WomenWhoCode/WomenWhoCode.git (push)

1. To update your local copy with remote changes, run the following:

   git fetch upstream

   git merge upstream/master

   This will give you an exact copy of the current remote, make sure you don't have any local changes.

Contributing and developing a feature

1. Make sure you are in the master branch git checkout master
2. Sync your copy git pull
3. Create a new branch with a meaningful name git checkout -b branch_name
4. Develop your feature on Android Studio and run it using the emulator or connecting your own Android device
5. Clean your project from Android Studio Build/Clean project
6. Add the files you changed git add file_name (avoid using git add .)
7. Commit your changes git commit -m "Message briefly explaining the feature"
8. We have small Pull Requests, try to keep one commit per feature. If you forgot to add changes, you can edit the previous commit git commit --amend
9. Push to your repo git push origin branch-name
10. Go into the Github repo and create a pull request explaining your changes
11. Please add a message on the pull request notifying your changes to @WomenWhoCode/android-reviewers
12. An @WomenWhoCode/android-reviewers will merge your PR when it's ready for merging 👍

Project Reviewers

• Shehba
• Puja
• Zassmin

You can metion all of us using @WomenWhoCode/android-reviewers

Join in on conversations related to this project!

• Sign Up for the Slack Group to discuss issues with fellow developers and contrbutors.*

Open Source Libraries Used

• Android Async HTTP - Simple asynchronous HTTP requests with JSON parsing
• Picasso - Image loading and caching library for Android
• Calligraphy - Custom fonts in Android an OK way.
• Material Tab Strip - An interactive indicator to navigate between the different pages of a ViewPager
• KenBurnsView - Android library that provides an extension to ImageView that creates an immersive experience by animating its drawable using the Ken Burns Effect.
• Android GIF Drawable - Views and Drawable for displaying animated GIFs on Android
• Butterknife - Field and method binding for Android views which uses annotation processing to generate boilerplate code for you.
• Glide - An image loading and caching library for Android focused on smooth scrolling
• Bubble View - Bubble View to implement chat conversation's UI.
• Material Spinner - Spinner with Material Design - Down to API 9
• Material Ripple - Android L Ripple effect wrapper for Views
• Recycler View Animators - An Android Animation library which easily add itemanimator to RecyclerView items.

Current App

https://www.youtube.com/watch?v=Tt4ATUSORzk

Open Source License

The Non-Profit Open Software License version 3.0 (NPOSL-3.0)

contact@womenwhocode.com for any questions

WWCode reserve the right to change the open source license at anytime