# Codespaces Workflow

A complete development environment can be accessed through [GitHub Codespaces](https://docs.github.com/codespaces/overview).

To get started, click the green "Code" button on the repository's main page, and then click "Create codespace on main":

![Create codespace](create_codespace.jpg)

After a minute or two, your codespace will be ready with a VSCode editor:

![Code editor](editor.jpg)

Before making changes, click on the "main" branch name at the bottom of the window:

![Branch button](branch_button.jpg)

Click "Create new branch" at the top of the window:

![Create branch](create_branch.jpg)

Enter a name for your branch and then press Enter:

![Branch name](branch_name.jpg)

Once you've made some changes, you can run the tests right here! Choose "Terminal" and then "Run Task" from the hamburger menu (3 lines) on the left sidebar:

![Run task](run_task.jpg)

Next, type "test" into the text box at the top and click "Run tests for current file":

![Run tests](run_tests.jpg)

In the terminal window below, you can see if the tests were successful:

![Test success](test_success.jpg)

When you've finished your changes, click the source control button on the left sidebar and then "Commit & Create Pull Request":

![Commit pull request](commit_pull_request.jpg)

Enter a commit message and click the checkmark button to complete:

![Commit message](commit_message.jpg)

Finally, enter a title and description for your pull request in the left sidebar. Click the "Create" button to submit:


![Create pull request](create_pull_request.jpg)
