Added github flow exercise

Author: GeekTrainer

content/guided-workshop/exercises/6-github-flow.md

@@ -0,0 +1,85 @@
+# GitHub flow
+
+The [GitHub flow](https://docs.github.com/en/get-started/quickstart/github-flow) is a lightweight, [branch-based](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-branches) workflow. It's designed to allow for free testing and exploration of ideas and novel approaches which are then reviewed and, if accepted, brought into the codebase. At a high level, the GitHub flow follows this pattern:
+
+1. Create a branch
+1. Make the desired changes
+1. Create a [pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests)
+1. Review changes, gather feedback and make updates
+1. Review results of automated operations such as testing for continuous integration
+1. If changes are approved, merge into codebase
+
+The GitHub flow is designed to work as a cycle, where contributors continuously explore, test, review, and build upon their work and the work of others.
+
+> **NOTE:** One key philosophy for GitHub flow is not every pull request needs to be merged. Sometimes exploration is the goal, the feature isn't one which is desired by the greater team, or wholesale changes need to be made necessitating starting over. This is part of the process, and allows for free experimentation.
+
+## Scenario
+
+With the code changes created in the [prior exercise](./5-coding.md), it's time to walk through the GitHub flow to create a pull request and incorporate the updates into the codebase. While the changes have already been made (meaning we are slightly out of order from the "traditional" flow), you can still perform the steps to explore.
+
+## Creating a branch
+
+A [branch](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-branches) is a copy of the code stored in the same repository. By using branches to test updates you have a safe space to explore while keeping all code in the same repository.
+
+There are different ways to create a branch when using [GitHub Codespaces](https://github.com/features/codespaces). You can utilize the command-line to run [git](https://git-scm.com/docs/git-branch) commands. You can use the Source Control pane in your codespace to get the support of the UI for creating your branch. In our example we're going to use the command-line to create the branch.
+
+1. Return to your codespace, or reopen it by navigating to your repository and selecting **Code** > **Codespaces** and the name of your codespace.
+1. Open a **terminal window** by pressing <kbd>Ctl</kbd> + <kbd>`</kbd>.
+1. In the terminal window, enter the following command to create and switch to a new branch named `add-hours` and pressing <kbd>Enter</kbd> (or <kbd>Return</kbd> on a Mac)::
+
+    ```bash
+    git checkout -b add-hours
+    ```
+
+1. Stage all code to be committed to the new branch by entering the following command in the terminal window and pressing <kbd>Enter</kbd> (or <kbd>Return</kbd> on a Mac):
+
+    ```bash
+    git add .
+    ```
+
+1. Commit all changes with a message describing what's been updated by entering the following command in the terminal window and pressing <kbd>Enter</kbd> (or <kbd>Return</kbd> on a Mac):
+
+    ```bash
+    git commit -m "Added hours component"
+    ```
+
+1. Finally, push the new branch to the repository by entering the following command in the terminal window and pressing <kbd>Enter</kbd> (or <kbd>Return</kbd> on a Mac):
+
+    ```bash
+    git push -u origin add-hours
+    ```
+
+## Create the pull request
+
+A [pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) is a request to pull or incorporate new code into the existing codebase. When a pull request is made it's customary to have other team members review the code and make comments, and for [CI/CD](https://resources.github.com/ci-cd/) processes to run. Once everything is completed and the code is in a stage where everyone has signed-off, it's then merged into the codebase.
+
+Pull requests can be made through the source control pane in the codespace, the repository's website, or through the command-line using the [GitHub CLI](https://cli.github.com/). In our example we're going to create the pull request in the CLI, then navigate to the website to see the pull request and the actions running, and merge the code into the codebase.
+
+1. Return to your codespace.
+1. Find the number for the [issue you created earlier](./2-issues.md) titled **Add component to display hours** by entering the following command in the terminal window and pressing <kbd>Enter</kbd> (or <kbd>Return</kbd> on a Mac):
+
+    ```bash
+    gh issue list
+    ```
+
+1. Create a pull request with the title **Add hours component** and body **Resolves #\<ISSUE_NUMBER\>**, replacing **\<ISSUE_NUMBER\>** with the issue number you obtained in the previous step by entering the following command in the terminal window and pressing <kbd>Enter</kbd> (or <kbd>Return</kbd> on a Mac):
+
+    ```bash
+    gh pr create -t "Add hours component" -b "Resolves #<ISSUE_NUMBER>"
+    ```
+
+## Merge the pull request
+
+When the pull request is created, you will see a link appear to the page for the pull request. From there you can add comments, see any workflows running, and decide to close or merge the pull request. Let's ensure the tests now run successfully and, assuming they do, merge the pull request.
+
+1. Follow the link displayed in the terminal window by using <kbd>Ctl</kbd> - **Click** (or <kbd>Cmd</kbd> - **Click** on a Mac).
+1. In the page displayed, note the workflow running the [end-to-end tests created earlier](./4-testing.md).
+1. When the test passes successfully, select **Merge pull request** to merge your changes into the **main** branch.
+
+Congratulations! You've now used the GitHub flow to suggest changes, perform a review, and merge those into your codebase.
+
+## Summary and next steps
+
+The GitHub flow is a workflow for managing changes and incorporating new features into a codebase. GitHub flow gives you the freedom to explore and experiment, while ensuring all code follows a validation process before being merged. With the code updated, it's time to deploy the project! The first step is to [create the deployment environment](./7-create-environment.md).
+
+## Resources