.. Team 573 Programming Documentation documentation master file, created by
   sphinx-quickstart on Thu Sep 13 19:58:13 2018.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Github
==============================================================
Github (https://github.com/) is an online code repository and it is were we host all our code. It allows use to branch the project out, so multiple people can work at once, and then easily merge it all back together through pull requests. We work in private repositories (repo) every season, then publish our final code after worlds. If you don't have access to this year's repo please talk to Coach Eric to get access.

It is free to create an account and you can make as many public repo's as you want for different projects.

Desktop Application
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
While the code is stored online it is worked on your local computer. So you need a way to send the files back and forth from the online repo. You can do this using command line tools, but it is much easier to use Github's Desktop client. You can install it here, https://desktop.github.com/ 

Team 573 Projects
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

2025 Offseason Repo - Adding SIM to code - (https://github.com/savage301/Team573CTRESwervewithSIM)

2025 Robot Repo - (https://github.com/frcteam573/first-2025-robot)

2024 Robot Repo - (https://github.com/frcteam573/first-2024-robot)

Commiting Your Code
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This explains how to commit you local changes to your inwork branch of the repo.
https://services.github.com/on-demand/github-desktop/add-commits-github-desktop

Creating Branch
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This explains how to create a new branch in a repo.
https://help.github.com/desktop/guides/contributing-to-projects/creating-a-branch-for-your-work/

Pull Requests
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This explains how to create a pull request. A pull request is needed to merge code into a different branch. The programming lead or mentor will approve the requests to merge the code.
https://help.github.com/desktop/guides/contributing-to-projects/creating-a-pull-request/

.. toctree::
   :maxdepth: 2