friederbluemle / 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.

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