Name: volunteers-iOS
Owner: Systers Open Source
Description: Volunteers (VOLA) is an app intended for the Systers community. With it, Systers members can search for nearby events and volunteering opportunities.
Created: 2017-05-12 09:28:04.0
Updated: 2018-04-25 17:54:39.0
Pushed: 2018-04-25 02:36:32.0
Size: 561
Language: Swift
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
Volunteers (VOLA) is an iOS app intended for the Systers community. With it, Systers members can search for nearby events and volunteering opportunities. The VOLA app facilitates networking within the Systers community. In particular, users can find affinity groups within the Systers community.
Fork the repo. Navigate to the project folder and install the required CocoaPods.
OLA/
install
If you are an authorized developer on this project, request access fo the GoogleService-Info.plist
and SecretKeys.plist
files. Add the plist files to the root of the project in XCode. The project can now be compiled and run.
If you are not yet an authorized developer on this project, you are still able to contribute, but will have to use your own GoogleService-Info.plist
and SecretKeys.plist
files. You can read more about the structure of the plist files on the project wiki.
You may get an error when trying to log into Facebook if you are not on the list of the app's approved testers. To become a test user or developer user, request to become one and provide your facebook ID or username.
If you're interested in contributing to the project, follow these steps:
For first time contributors, it's recommended to work on issues marked
Priority: LOW
or writing additional unit tests to improve code coverage.
Once you've made a pull request, it will be reviewed by at least one of the project maintainers or contributors. If any changes are required, the reviewer will make requested changes on the pull request. In this case, you should address the requested changes so that the pull request will be approved. When the pull request is approved, it will be merged onto the project.
Pull requests to the project should follow this format:
#<number of issue>: <brief summary>
mmit summary 1
mmit summary 2
Following this format makes your pull request easier to review and more likely to be approved.
Commit messages should follow this format:
#<number of issue>: <brief summary>
lletpoint 1
lletpoint 2
Unit tests are included on this project, and they are passing on a clean slate. If you would like to contribute by writing unit tests, your additional unit tests should also pass on a clean late.
If you are adding a new feature to the project, ensure that the current unit tests still pass. If your new feature is not covered by the current unit tests, it is ideal to include unit tests for your feature.
This project is equipped with a linter to help keep the code clean and consistent. Your pull request should have no lint warnings except where applicable (e.g. TODO
, FIXME
). Even then, your pull request should avoid adding TODO
s and FIXME
s unless absolutely necessary.
If you need help, you should first consult the available project documentation on the wiki. If the wiki doesn't answer your question, you can post a question in the #vola
channel on the Systers Open Source Slack. You can tag @connie
in the channel if you don't get a response to your question.