/START_HERE

This repo outlines how to get started contributing to Operation Code, each of our projects, the language they are written in, and their purpose.


Operation Code Hacktoberfest Banner

Welcome!

Welcome to Operation Code and thank you for your interest in contributing. Everything Operation Code does is open source. We love to receive contributions to our community — you! There are many ways to contribute, from writing tutorials or blog posts, improving the documentation, submitting bug reports and feature requests or writing code which can be incorporated into the website itself.

We've got quite a few repos, and we understand that can be overwhelming, so you can use this list to learn what the main applications are, and what languages they use.

In addition to any of these projects, you can join our Slack channel #oc-projects to learn how to contribute.

If you find yourself wishing for a feature that doesn't exist, you are probably not alone! There are bound to be others out there with similar needs. Many of the features that we have today were added because our users saw the need. Open an issue on our issues list on GitHub which describes the feature you would like to see, why you need it, and how it should work.

Your First Contribution

Working on your first Pull Request? You can learn how from this free series, How to Contribute to an Open Source Project on GitHub.

Feel free to ask for help; everyone is a beginner at first 😸 If a maintainer asks you to "rebase" your PR, they're saying that a lot of code has changed and that you need to update your branch so it's easier to merge.

Once you've joined Operation Code as a member, after your first PR (pull request) contribution is accepted, please fill out this form to get your sticker!

Operation Code Challenge

Purpose A challenge for participating with operationcode.org and getting help with available resources
Languages You can contribute to a project in any language or modify a current project with the language you prefer.
Frameworks Open choice depending on the project
Link GitHub Repo

Open Source Maintenance Policy

You can find our official Open Source Maintenance Policy in this repo.

OperationCode Backend

Purpose The backend API for operationcode.org
Languages Ruby
Frameworks Rails
Link GitHub Repo

OperationCode Frontend

Purpose The frontend for operationcode.org
Languages Javascript
Frameworks React
Link GitHub Repo

Town Crier

Purpose Slack bot with a cron like interface to notify members of Operation Code opportunities
Languages Javascript
Frameworks node.js
Link GitHub Repo

OperationCode Bot

Purpose Slack bot for dealing with slack events. Primarily used to display interactive slack messages to create a menu-like interface
Languages Ruby
Frameworks Sinatra
Link GitHub Repo

OperationCodePyBot

Purpose Slack python bot for dealing with slack events. Primary use for interacting with new members. Currently in initial development stages.
Languages Python
Frameworks Sinatra
Link GitHub Repo

OperationCode Slash Commands

Purpose Slack bot that allows users to get information via slack's slash command UI (eg /events)
Languages Javascript
Frameworks node.js
Link GitHub Repo

Opentroops Projects

Various open source projects with veteran and military-affiliated contributors, and projects supporting military social issues.

Name Description Link
National Veterans Job Platform One job one veteran at a time JobOps GitHub
Department of Veterans Affairs Developer Area This is a repository of APIs and data related to the Department of Veterans Affairs (VA). These APIs, data, tools and resources are intended to provide developers with what they need to develop web and mobile applications, design data visualizations and stories using resources from the VA. VaDeveloper GitHub
Department of Veterans Affairs Repo Beta version of vets.gov Vets.gov GitHub
Mil-OSS Repo for mil-oss, a group dedicated to utilizing & developing open technologies for national defense mil-oss GitHub
startups.vet data analyzation Project to analyze veteran entrepreneurship data from startups.vet GitHub
Veteran-led Companies Database Project to collect data on veteran-owned companies Veteran Companies GitHub