EBWiki.org is a site dedicated to documenting when people of color are killed by law enforcement officers during routine interactions.

The release of the Walter Scott body-cam video in 2015 showed the vast discrepancy between the official report of the encounter and the video. After seeing the video, a group of Black technologists had the idea of a site where information on each encounter could be stored and recorded. This would help show both the frequency with which this occurs as well as the way bias affects the proceedings.

Our idea, EBWiki, is designed to highlight not only the original incident between law enforcement and victims but also what happens to the family, police officers, and communities afterwards. Our goal is to become the most comprehensive resource on people of color killed by law enforcement in the United States and Canada. Our hope is that, by shedding light on these incidents, we will move and empower others to come together to create and enact solutions.

Any and all developers are welcome to contribute to the codebase. For general information on contributing, please read this guide on developing for EBWiki before selecting your first issue.

If this is your first open source contribution, welcome! We're glad that you chose to get started with us. You can find some good first issues labelled exactly that, good first issue.

We ask that, if possible, you address issues that are labelled quick fix first, followed by those marked as high priority. Otherwise, you're free to select any issue that seems interesting to you. There are times when we may ask you to switch to another issue, as we match dev work against our internal roadmap, but that's not something you need to worry about. In that case, we'll just let you know and provide another issue you might be interested in.

All contributors are expected to adhere to our code of conduct, which can be found here. Thank you for your contribution - details on our stack and setting up a local environment can be found below.

Instructions on setting up a local development environment can be found in the following documents:

• Set Up Locally with Docker.
• Set Up Locally with All Services (Full Stack).

In general, contributors will use the following languages, frameworks, and technologies:

• Ruby 2.6.6
• Rails 5.0.7
• Elasticsearch
• Postgres 12 or higher
• Redis
• AWS S3
• NodeJS

We use RSpec, shoulda-matchers, and FactoryBot for our tests. You can run the tests locally with the following commands:

rspec spec/

More information on how to use RSpec, shoulda-matchers, and FactoryBot can be found at the links above.

We also use Rubocop as part of our continous integration process in Github Actions. To run Rubocop locally, enter

rubocop

Each time a pull request (PR) is opened or updated

The full test suite will be run, to ensure that submitted changes do not break functionality elsewhere in the app. Brakeman, Rubocop, and a link checker will also be run on the submitted changes.

As noted in our development guide, your PR is expected to pass all checks before a maintainer will merge it. If your PR is failing one of the checks, refer to our development guide for tips on how to address the failure(s).

EBWiki is currently hosted on Heroku. We have two environments - staging and production. If you're interested in contributing but are more of a DevOps person than a developer, feel free to send us a message at [email protected] to see how you can get involved.

The staging app does require credentials to access the app. If you need to access the staging app send us a message at [email protected] to get a copy of the credentials.

Want to report a bug you found? Feel free to create a new issue for it! Please be sure to use the bug template we've created for issues. Additionally, check our docs here and the guides on EBWiki first to see if your issue has already been addressed.

Have any questions not covered in our docs? Feel free to send us a message at [email protected].

Thank you to all of our contributors. Contributors to the codebase can be found here.

EBWiki is using the Apache 2.0 License.