From 66f5db3158fe8c9695cc8855160cf796ffbb996e Mon Sep 17 00:00:00 2001 From: Russell Ferri Date: Mon, 8 Feb 2016 11:55:44 -0500 Subject: [PATCH 01/21] Fix clone your fork section --- walkthrough/1-setup.md | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/walkthrough/1-setup.md b/walkthrough/1-setup.md index 570d5026..ac9e62a2 100644 --- a/walkthrough/1-setup.md +++ b/walkthrough/1-setup.md @@ -15,15 +15,18 @@ Fork the source repository: 1. Visit https://github.com/source-username/repository-name. 2. Click the "fork" button, and choose your personal GitHub account if prompted. +--- + +:cop: :raised_hand: - Please wait until everyone has caught up. + +:construction: :construction: :construction: :construction: :construction: :construction: :construction: :construction: :construction: :construction: :construction: :construction: :construction: :construction: :construction: + +--- ### 2 - Clone your Fork __All Team Members__ -Fork the source repository: - 1. Visit https://github.com/source-username/repository-name. - 2. Click the "fork" button, and choose your personal GitHub account if prompted. - Clone your fork to your local machine: ```sh $ cd ~/my/parent/directory From 7c17ea1b6ceae6ebb1acbb6f8b3220802761ce01 Mon Sep 17 00:00:00 2001 From: Russell Ferri Date: Mon, 8 Feb 2016 12:00:54 -0500 Subject: [PATCH 02/21] change username refs to your-username --- walkthrough/1-setup.md | 14 +++++++------- walkthrough/3-code-review.md | 4 ++-- 2 files changed, 9 insertions(+), 9 deletions(-) diff --git a/walkthrough/1-setup.md b/walkthrough/1-setup.md index ac9e62a2..746bf75d 100644 --- a/walkthrough/1-setup.md +++ b/walkthrough/1-setup.md @@ -30,7 +30,7 @@ __All Team Members__ Clone your fork to your local machine: ```sh $ cd ~/my/parent/directory -$ git clone https://github.com/username/repository-name.git +$ git clone https://github.com/your-username/repository-name.git # clone the fork repository from GitHub $ cd repository-name @@ -43,16 +43,16 @@ $ git remote origin $ git remote -v -origin https://github.com/username/repository-name.git (fetch) -origin https://github.com/username/repository-name.git (push) +origin https://github.com/your-username/repository-name.git (fetch) +origin https://github.com/your-username/repository-name.git (push) ``` You should see an `origin` remote that points to your GitHub fork: ```sh $ git remote show origin * remote origin - Fetch URL: https://github.com/username/repository-name.git - Push URL: https://github.com/username/repository-name.git + Fetch URL: https://github.com/your-username/repository-name.git + Push URL: https://github.com/your-username/repository-name.git HEAD branch: master Remote branches: develop tracked @@ -101,8 +101,8 @@ $ git remote add source https://github.com/source-username/repository-name.git # add the source remote $ git remote -v -origin https://github.com/username/repository-name.git (fetch) -origin https://github.com/username/repository-name.git (push) +origin https://github.com/your-username/repository-name.git (fetch) +origin https://github.com/your-username/repository-name.git (push) source https://github.com/source-username/repository-name.git (fetch) source https://github.com/source-username/repository-name.git (push) ``` diff --git a/walkthrough/3-code-review.md b/walkthrough/3-code-review.md index f9bdffb2..e6b30152 100644 --- a/walkthrough/3-code-review.md +++ b/walkthrough/3-code-review.md @@ -46,8 +46,8 @@ $ git remote add teammate https://github.com/teammmate-username/repository-name. # add the teammate remote $ git remote -v -origin https://github.com/username/repository-name.git (fetch) -origin https://github.com/username/repository-name.git (push) +origin https://github.com/your-username/repository-name.git (fetch) +origin https://github.com/your-username/repository-name.git (push) source https://github.com/source-username/repository-name.git (fetch) source https://github.com/source-username/repository-name.git (push) teammate https://github.com/teammate-username/repository-name.git (fetch) From 70be2cb44eacff64442397bc4dac61dcf0a4b890 Mon Sep 17 00:00:00 2001 From: Russell Ferri Date: Mon, 8 Feb 2016 12:07:01 -0500 Subject: [PATCH 03/21] prefx commands with $ --- walkthrough/1-setup.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/walkthrough/1-setup.md b/walkthrough/1-setup.md index 746bf75d..6e58bf2f 100644 --- a/walkthrough/1-setup.md +++ b/walkthrough/1-setup.md @@ -167,19 +167,19 @@ __All Team Members__ By now you should have noticed that you do not have a local `develop` branch ```sh -git branch +$ git branch * master ``` Create a `develop` branch that tracks from your GitHub fork's `develop` branch: ```sh -git branch develop origin/develop +$ git branch develop origin/develop Branch develop set up to track remote branch develop from origin ``` Notice that viewing the details for the `origin` remote indicates that the local `develop` and `master` branches are configured to push to and pull from your GitHub fork's branches: ```sh -git remote show origin +$ git remote show origin ... Local branches configured for 'git pull': develop merges with remote develop @@ -191,7 +191,7 @@ git remote show origin :bulb: The `-vv` flag for the `git branch` command will also show the remote branches that are tracked by your local branches (in brackets): ```sh -git branch --vv +$ git branch --vv develop 3e03a92 [origin/develop] Create example app * master 3e03a92 [origin/master] Create example app ``` From ed3c66ba490ca9ded475f220d8079fae1868235d Mon Sep 17 00:00:00 2001 From: Russell Ferri Date: Mon, 8 Feb 2016 12:08:51 -0500 Subject: [PATCH 04/21] fix --vv --- walkthrough/1-setup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/walkthrough/1-setup.md b/walkthrough/1-setup.md index 6e58bf2f..cbb6daf8 100644 --- a/walkthrough/1-setup.md +++ b/walkthrough/1-setup.md @@ -191,7 +191,7 @@ $ git remote show origin :bulb: The `-vv` flag for the `git branch` command will also show the remote branches that are tracked by your local branches (in brackets): ```sh -$ git branch --vv +$ git branch -vv develop 3e03a92 [origin/develop] Create example app * master 3e03a92 [origin/master] Create example app ``` From 07aca4f258c4be14e01b4403832a2ca16c2110e9 Mon Sep 17 00:00:00 2001 From: Russell Ferri Date: Mon, 8 Feb 2016 12:31:23 -0500 Subject: [PATCH 05/21] Move 'you are ready' paragraph before wait message --- walkthrough/1-setup.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/walkthrough/1-setup.md b/walkthrough/1-setup.md index cbb6daf8..8c0e166a 100644 --- a/walkthrough/1-setup.md +++ b/walkthrough/1-setup.md @@ -196,6 +196,8 @@ $ git branch -vv * master 3e03a92 [origin/master] Create example app ``` +You should now be ready to move on to the rest of the walkthrough. If you'd like to see the repository you've created on your local machine in GitHub desktop, you can add a repository by choosing a local path. + --- :cop: :raised_hand: - Please wait until everyone has caught up. @@ -204,8 +206,6 @@ $ git branch -vv --- -You should now be ready to move on to the rest of the walkthrough. If you'd like to see the repository you've created on your local machine in GitHub desktop, you can add a repository by choosing a local path. - ## Next Next we will walk through the process of creating feature branches, publishing changes to GitHub, and making a request to merge changes into the source repository using a Pull Request. From 5bd3e58667c1564438a4265d2f596cb7a333e116 Mon Sep 17 00:00:00 2001 From: Russell Ferri Date: Mon, 8 Feb 2016 12:39:31 -0500 Subject: [PATCH 06/21] adding info message about feature branch names --- walkthrough/2-feature-branches.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/walkthrough/2-feature-branches.md b/walkthrough/2-feature-branches.md index e27e7fad..f6054aab 100644 --- a/walkthrough/2-feature-branches.md +++ b/walkthrough/2-feature-branches.md @@ -35,6 +35,8 @@ $ git branch * master ``` +:bulb: Feature branches will be named such that someone else can look at what branches are in progress and get a rough idea of what work is being done on each branch. + Next, switch to the newly created feature branch: ```sh $ git checkout cuba-pudding-jr-feb From 9cd5b8ca260f3be30c553ae4a50aa60ad64b7388 Mon Sep 17 00:00:00 2001 From: Russell Ferri Date: Mon, 8 Feb 2016 12:41:48 -0500 Subject: [PATCH 07/21] remove extra _ --- walkthrough/2-feature-branches.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/walkthrough/2-feature-branches.md b/walkthrough/2-feature-branches.md index f6054aab..818e066a 100644 --- a/walkthrough/2-feature-branches.md +++ b/walkthrough/2-feature-branches.md @@ -64,7 +64,7 @@ Switched to a new branch 'cuba-pudding-jr-feb' ### 2 - Make Changes to the Project -__All Team Members___ +__All Team Members__ In your text editor, make the following changes: 1. Add the new recipe under the [`/app/recipe/feb/`](/app/recipe/feb/) directory. From 02318ab2043d427b1224f1a76537c50c2491baaa Mon Sep 17 00:00:00 2001 From: Russell Ferri Date: Mon, 8 Feb 2016 12:42:34 -0500 Subject: [PATCH 08/21] remove extra _ --- walkthrough/2-feature-branches.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/walkthrough/2-feature-branches.md b/walkthrough/2-feature-branches.md index 818e066a..e81688a4 100644 --- a/walkthrough/2-feature-branches.md +++ b/walkthrough/2-feature-branches.md @@ -83,7 +83,7 @@ Since other people are going to be making changes at the same time, be careful n ### 3 - Diff Changes -__All Team Members___ +__All Team Members__ If you view the current git status, you will see 2 files with unstaged changes and a new folder that has not been tracked by git: ```sh From 4b74c8118803f7972ab7b5b28eec7d57ea9a2e67 Mon Sep 17 00:00:00 2001 From: Russell Ferri Date: Mon, 8 Feb 2016 12:43:55 -0500 Subject: [PATCH 09/21] fix markdown list formatting --- walkthrough/2-feature-branches.md | 1 + 1 file changed, 1 insertion(+) diff --git a/walkthrough/2-feature-branches.md b/walkthrough/2-feature-branches.md index e81688a4..e18a28cf 100644 --- a/walkthrough/2-feature-branches.md +++ b/walkthrough/2-feature-branches.md @@ -67,6 +67,7 @@ Switched to a new branch 'cuba-pudding-jr-feb' __All Team Members__ In your text editor, make the following changes: + 1. Add the new recipe under the [`/app/recipe/feb/`](/app/recipe/feb/) directory. 2. Update the writer's page in the [`/app/writer/`](/app/writer/) direcotry. 3. Update the main mage [`/app/index.md`](/app/index.md). From 6e817ee4eeb1830c5b0188765fe1be9aca4ee4f6 Mon Sep 17 00:00:00 2001 From: Russell Ferri Date: Mon, 8 Feb 2016 12:45:55 -0500 Subject: [PATCH 10/21] fix typo --- walkthrough/2-feature-branches.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/walkthrough/2-feature-branches.md b/walkthrough/2-feature-branches.md index e18a28cf..d09e7b0b 100644 --- a/walkthrough/2-feature-branches.md +++ b/walkthrough/2-feature-branches.md @@ -69,7 +69,7 @@ __All Team Members__ In your text editor, make the following changes: 1. Add the new recipe under the [`/app/recipe/feb/`](/app/recipe/feb/) directory. -2. Update the writer's page in the [`/app/writer/`](/app/writer/) direcotry. +2. Update the writer's page in the [`/app/writer/`](/app/writer/) directory. 3. Update the main mage [`/app/index.md`](/app/index.md). Since other people are going to be making changes at the same time, be careful not to make changes to lines of code that are not relevant to your change. From 89aa88210c586df7bc0edb1b5c632fc74178ae17 Mon Sep 17 00:00:00 2001 From: Russell Ferri Date: Mon, 8 Feb 2016 12:54:14 -0500 Subject: [PATCH 11/21] cleaning up feature branches walkthrough --- walkthrough/2-feature-branches.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/walkthrough/2-feature-branches.md b/walkthrough/2-feature-branches.md index d09e7b0b..857bc5cc 100644 --- a/walkthrough/2-feature-branches.md +++ b/walkthrough/2-feature-branches.md @@ -82,7 +82,7 @@ Since other people are going to be making changes at the same time, be careful n --- -### 3 - Diff Changes +### 3 - Review Changes __All Team Members__ @@ -117,7 +117,7 @@ index ac3abad..9777cd5 100644 ### [Cuba Pudding Jr.](writer/cuba-pudding-jr.md) | cubapud@flavor.magazine -[Grilled Peach Salad](recipe/jan/grilled-peach-salad.md) -+[Quick Oatmeal Pancakes]( recipe/feb/quick-oatmeal-pancakes.md) ++[Quick Oatmeal Pancakes](recipe/feb/quick-oatmeal-pancakes.md) ### [Eggs Benny](writer/eggs-benny.md) | englishmuffin@flavor.magazine From 9c5d4caba4b938c2110f0ef27186c7bec939a98b Mon Sep 17 00:00:00 2001 From: Russell Ferri Date: Mon, 8 Feb 2016 12:55:04 -0500 Subject: [PATCH 12/21] fix markdown list formatting --- walkthrough/3-code-review.md | 1 + 1 file changed, 1 insertion(+) diff --git a/walkthrough/3-code-review.md b/walkthrough/3-code-review.md index e6b30152..87da21c0 100644 --- a/walkthrough/3-code-review.md +++ b/walkthrough/3-code-review.md @@ -17,6 +17,7 @@ __All Team Members__ Navigate to the source repository on GitHub, click the "Pull Requests" tab, and click on the Pull Request opened by the team member sitting to your right. Review the following things: + 1. Verify that the user is requesting to merge their feature branch into the `develop` branch. 2. Check to see if there is any important information on the Conversation tab. 3. Check the Commits tab to get a high-level view of the individual changes that were made. From 32389610b10ab435003dd1f143d2ba988a7f5ba8 Mon Sep 17 00:00:00 2001 From: Russell Ferri Date: Mon, 8 Feb 2016 13:01:56 -0500 Subject: [PATCH 13/21] fix typo: teammmate --- walkthrough/3-code-review.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/walkthrough/3-code-review.md b/walkthrough/3-code-review.md index 87da21c0..0202d9f1 100644 --- a/walkthrough/3-code-review.md +++ b/walkthrough/3-code-review.md @@ -43,7 +43,7 @@ If you are curious to run someone else's code locally, you will need to set up a Create a remote pointing to the person to your right's Fork: ```sh -$ git remote add teammate https://github.com/teammmate-username/repository-name.git +$ git remote add teammate https://github.com/teammate-username/repository-name.git # add the teammate remote $ git remote -v From a752151a34eea48230a879d492e3eb42249453c8 Mon Sep 17 00:00:00 2001 From: Russell Ferri Date: Mon, 8 Feb 2016 13:07:42 -0500 Subject: [PATCH 14/21] add instuction to run git log on teammate branch --- walkthrough/3-code-review.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/walkthrough/3-code-review.md b/walkthrough/3-code-review.md index 0202d9f1..364c5419 100644 --- a/walkthrough/3-code-review.md +++ b/walkthrough/3-code-review.md @@ -76,6 +76,20 @@ Switched to a new branch 'teammate-feature-branch' Now you've switched the code in your directory to a branch containing all of the changes committed to your teammate's branch. If you have your project open in sublime or another text editor you will notice that the source files contain your teammate's changes. +If you run the `git log` command you can see a log of the latest commits made to the current branch: +```sh +$ git log +commit 6b7a7c2bc46753d0d394758b8fd04bcd3b4cf896 +Author: My Teammate +Date: Mon Feb 8 12:58:20 2016 -0500 + + Adding Eggs Benny February Recipe + +... +``` + +:bulb: Press enter to scroll through lines & Ctrl+C to exit the log. + Once you are done, you can delete this branch: ```sh $ git checkout develop From 564c45c1248e99df8e241f8e195809a4b0cceda2 Mon Sep 17 00:00:00 2001 From: Russell Ferri Date: Fri, 5 May 2017 09:26:12 -0400 Subject: [PATCH 15/21] Update walkthrough --- README.md | 2 +- walkthrough/1-setup.md | 82 +++++++++++++----------------- walkthrough/2-feature-branches.md | 23 +++++---- walkthrough/3-code-review.md | 14 +++-- walkthrough/4-fetching-latest.md | 22 ++------ walkthrough/5-hotfix.md | 15 +++--- walkthrough/6-release-branch.md | 14 +---- walkthrough/7-release-bugs.md | 10 ++-- walkthrough/8-completed-release.md | 30 ++++++----- 9 files changed, 93 insertions(+), 119 deletions(-) diff --git a/README.md b/README.md index aea30079..9411ce3a 100644 --- a/README.md +++ b/README.md @@ -29,7 +29,7 @@ Please leave this repository open in a browser tab so that you can follow along ## Next -Next we will walk through the process of creating a Fork repository and setting up a local clone. +Next we will walk through the process of creating a GitHub Fork and local clone of this repository. [Go](/walkthrough/1-setup.md) diff --git a/walkthrough/1-setup.md b/walkthrough/1-setup.md index 11d94354..94fab5b1 100644 --- a/walkthrough/1-setup.md +++ b/walkthrough/1-setup.md @@ -1,6 +1,6 @@ # 1. Setup -In order to contribute to a GitHub project, you will need two things: a Fork of the project and a local clone of your Fork. +In order to contribute to a GitHub project, you will need two things: a GitHub Fork and a local clone of this project. ## :running: Activities @@ -27,10 +27,10 @@ Fork the source repository: __All Team Members__ -Clone your fork to your local machine: +Clone this project to your local machine: ```sh $ cd ~/my/parent/directory -$ git clone https://github.com/your-username/repository-name.git +$ git clone https://github.com/source-username/repository-name.git # clone the fork repository from GitHub $ cd repository-name @@ -43,16 +43,16 @@ $ git remote origin $ git remote -v -origin https://github.com/your-username/repository-name.git (fetch) -origin https://github.com/your-username/repository-name.git (push) +origin https://github.com/source-username/repository-name.git (fetch) +origin https://github.com/source-username/repository-name.git (push) ``` -You should see an `origin` remote that points to your GitHub fork: +You should see an `origin` remote that points to the source GitHub project: ```sh $ git remote show origin * remote origin - Fetch URL: https://github.com/your-username/repository-name.git - Push URL: https://github.com/your-username/repository-name.git + Fetch URL: https://github.com/source-username/repository-name.git + Push URL: https://github.com/source-username/repository-name.git HEAD branch: master Remote branches: develop tracked @@ -91,66 +91,54 @@ $ git branch -a --- -### 3 - Add Remote for Source Repository +### 3 - Add Remote for your GitHub Fork __All Team Members__ -Add a `source` remote: +Add a `me` remote: ```sh -$ git remote add source https://github.com/source-username/repository-name.git -# add the source remote +$ git remote add me https://github.com/your-username/repository-name.git +# add the me remote $ git remote -v -origin https://github.com/your-username/repository-name.git (fetch) -origin https://github.com/your-username/repository-name.git (push) -source https://github.com/source-username/repository-name.git (fetch) -source https://github.com/source-username/repository-name.git (push) +origin https://github.com/source-username/repository-name.git (fetch) +origin https://github.com/source-username/repository-name.git (push) +me https://github.com/your-username/repository-name.git (fetch) +me https://github.com/your-username/repository-name.git (push) ``` -You should see a `source` remote that points to the upstream GitHub source repository: +You should see a `me` remote that points to your GitHub Fork repository: ```sh -$ git remote show source -* remote origin - Fetch URL: https://github.com/source-username/repository-name.git - Push URL: https://github.com/source-username/repository-name.git +$ git remote show me +* remote me + Fetch URL: https://github.com/your-username/repository-name.git + Push URL: https://github.com/your-username/repository-name.git HEAD branch: master Remote branches: - develop new (next fetch will store in remotes/source) - master new (next fetch will store in remotes/source) + develop new (next fetch will store in remotes/me) + master new (next fetch will store in remotes/me) Local ref configured for 'git push': master pushes to master (up to date) ``` Maintainers will need to create branches and push directly to the source repository. -All team members will need to pull changes from the source repository and merge them into -their own branches. +All team members will need to pull changes from the source repository in order to branch from for feature branches. -Fetch branch data from the `source` remote: +Fetch branch data from the `origin` remote: ```sh -$ git fetch source +$ git fetch origin From https://github.com/source-username/repository-name -* [new branch] develop -> source/develop -* [new branch] master -> source/master +* [new branch] develop -> origin/develop +* [new branch] master -> origin/master $ git branch -a * master remotes/origin/HEAD -> origin/master remotes/origin/develop remotes/origin/master - remotes/source/develop - remotes/source/master - -$ git remote show source -* remote source - Fetch URL: https://github.com/source-username/repository-name.git - Push URL: https://github.com/source-username/repository-name.git - HEAD branch: master - Remote branches: - develop tracked - master tracked - Local ref configured for 'git push': - master pushes to master (up to date) + remotes/me/develop + remotes/me/master ``` --- @@ -171,13 +159,13 @@ $ git branch * master ``` -Create a `develop` branch that tracks from your GitHub fork's `develop` branch: +Create a `develop` branch that tracks from `origin`'s `develop` branch: ```sh -$ git branch develop origin/develop +$ git checkout -b develop --track origin/develop Branch develop set up to track remote branch develop from origin ``` -Notice that viewing the details for the `origin` remote indicates that the local `develop` and `master` branches are configured to push to and pull from your GitHub fork's branches: +Notice that viewing the details for the `origin` remote indicates that the local `develop` and `master` branches are configured to push to and pull from the source GitHub repository's branches: ```sh $ git remote show origin ... @@ -192,8 +180,8 @@ $ git remote show origin :bulb: The `-vv` flag for the `git branch` command will also show the remote branches that are tracked by your local branches (in brackets): ```sh $ git branch -vv - develop 3e03a92 [origin/develop] Create example app -* master 3e03a92 [origin/master] Create example app +* develop 3e03a92 [origin/develop] Create example app + master 3e03a92 [origin/master] Create example app ``` You should now be ready to move on to the rest of the walkthrough. If you'd like to see the repository you've created on your local machine in GitHub desktop, you can add a repository by choosing a local path. diff --git a/walkthrough/2-feature-branches.md b/walkthrough/2-feature-branches.md index 70467265..255f6641 100644 --- a/walkthrough/2-feature-branches.md +++ b/walkthrough/2-feature-branches.md @@ -27,12 +27,12 @@ Create a feature branch off of the `develop` branch that contains the writer's n ```sh $ git checkout develop -$ git branch cuba-pudding-jr-feb +$ git checkout -b cuba-pudding-jr-feb $ git branch - cuba-pudding-jr-feb +* cuba-pudding-jr-feb develop -* master + master ``` :bulb: Feature branches will be named such that someone else can look at what branches are in progress and get a rough idea of what work is being done on each branch. @@ -48,10 +48,9 @@ $ git branch master ``` -:bulb: You can simplify the last two steps to create and switch to a branch with a single command: +:bulb: You can create a branch without immediately checking out the branch via the `git branch` command: ```sh -$ git checkout -b cuba-pudding-jr-feb -Switched to a new branch 'cuba-pudding-jr-feb' +$ git branch cuba-pudding-jr-feb ``` --- @@ -150,9 +149,8 @@ If you see that you have changes to unexpected lines, please correct them at thi Stage all of the changes that you've made thus far: ```sh -$ git add -A -# Careful, -A stages changes to all tracked files, untracks files that have been -# removed, and tracks files that have been added. +$ git add app/* +# Careful, using a wildcard adds any file that has changed that matches the pattern. $ git status On branch cuba-pudding-jr-feb @@ -185,10 +183,13 @@ $ git commit -m "Adding Cuba Pudding Jr.'s Feb Recipe" Now that your changes have been committed, let's get them published to your Fork on GitHub: ```sh -$ git push origin cuba-pudding-jr-feb +$ git push -u me HEAD ``` -:bulb: Make sure you type the correct branch name. +:bulb: Specifying the HEAD reference instructs git to push to the same branch as the HEAD of your local project, which is currently your feature branch. + +:bulb: The `-u` flag instructs git to link your local branch with the remote's branch so that future push & pull commands do not require you +to specify where you would like to push or pull code from. Navigate to your Fork on Github, you should now see your new branch in the interface. diff --git a/walkthrough/3-code-review.md b/walkthrough/3-code-review.md index 1b6d522d..999f724a 100644 --- a/walkthrough/3-code-review.md +++ b/walkthrough/3-code-review.md @@ -47,10 +47,10 @@ $ git remote add teammate https://github.com/teammate-username/repository-name.g # add the teammate remote $ git remote -v -origin https://github.com/your-username/repository-name.git (fetch) -origin https://github.com/your-username/repository-name.git (push) -source https://github.com/source-username/repository-name.git (fetch) -source https://github.com/source-username/repository-name.git (push) +me https://github.com/your-username/repository-name.git (fetch) +me https://github.com/your-username/repository-name.git (push) +origin https://github.com/source-username/repository-name.git (fetch) +origin https://github.com/source-username/repository-name.git (push) teammate https://github.com/teammate-username/repository-name.git (fetch) teammate https://github.com/teammate-username/repository-name.git (push) ``` @@ -69,11 +69,15 @@ $ git branch -r --list teammate/* Checkout a tracking branch: ```sh -$ git checkout -b teammate-feature-branch teammate/eggs-benny-feb +$ git checkout eggs-benny-feb Branch teammate-feature-branch set up to track remote branch eggs-benny-feb from teammate. Switched to a new branch 'teammate-feature-branch' ``` +:bulb: As long as only one of your remotes has a branch called eggs-benny-feb, it knows to create a local tracking branch. + +:bulb: If you do not wish to create a tracking branch, you can check out the branch in read-only mode by fully-specifying the branch instead (e.g., `teammate/eggs-benny-feb`) + Now you've switched the code in your directory to a branch containing all of the changes committed to your teammate's branch. If you have your project open in sublime or another text editor you will notice that the source files contain your teammate's changes. If you run the `git log` command you can see a log of the latest commits made to the current branch: diff --git a/walkthrough/4-fetching-latest.md b/walkthrough/4-fetching-latest.md index ad0133f3..2607ea7b 100644 --- a/walkthrough/4-fetching-latest.md +++ b/walkthrough/4-fetching-latest.md @@ -8,31 +8,17 @@ Now that mods have been merged into the development branch, it is prudent to get ## :running: Activities -Follow along with the activities below to walk through the process of fetching the latest commits to the `source/develop` branch, merging them into your local `develop` branch, and publishing them back out to your GitHub fork. +Follow along with the activities below to walk through the process of pulling the latest commits to the `origin/develop` branch into your local tracking branch. -### 1 - Fetch Latest from Source +### 1 - Pull Latest from `develop` __All Team Members__ -Fetch the latest commits from the source repository: -```sh -$ git fetch source -``` - -Merge the new commits contained in the `source/develop` branch into your `develop` branch: +Pull the latest commits to the `develop` branch from the source repository: ```sh $ git checkout develop -# switch to develop branch -$ git merge source/develop -# merge commits from source/develop into your current branch (develop) -``` - -Your local `develop` branch is now up to date with the source `develop` branch. - -Now, publish your develop branch out to your GitHub fork: -```sh -$ git push origin develop +$ git pull ``` ## Next diff --git a/walkthrough/5-hotfix.md b/walkthrough/5-hotfix.md index 333e5100..9aaf5ce7 100644 --- a/walkthrough/5-hotfix.md +++ b/walkthrough/5-hotfix.md @@ -54,11 +54,9 @@ __Maintainers__ Choose a maintainer to publish the hotfix branch. This maintainer should push the branch to source: ```sh -$ git push source hotfix-1.0.1 +$ git push -u origin HEAD ``` -At this time create a pull request to merge the hotfix branch into `master`, but do not yet merge. - --- :cop: :raised_hand: - Please wait until everyone has caught up. @@ -114,7 +112,7 @@ Choose a developer to publish the fixup branch and create a Pull Request against Publish the branch: ```sh -$ git push origin remove-emails +$ git push -u me HEAD ``` Navigate to your GitHub fork and open the pull request, making sure to request to merge changes into the `hotfix-1.0.1` branch. @@ -157,16 +155,17 @@ $ git pull Merge hotfix into develop, creating a new merge commit (via `--no-ff`): ```sh $ git checkout develop -# switch to develop -$ git merge hotfix-1.0.1 --no-ff -m "Merging 1.0.1" +$ git pull + +$ git merge --no-ff hotfix-1.0.1 ``` :bulb: Always make sure that `develop` is up to date before merging. There may be some merge conflicts that will need to be addressed at this point. -Choose a maintainer to push the the commit up to the source repository: +Push the commit up to the source repository: ```sh -$ git push source develop +$ git push ``` ## Next diff --git a/walkthrough/6-release-branch.md b/walkthrough/6-release-branch.md index 73412da4..e5d2ea90 100644 --- a/walkthrough/6-release-branch.md +++ b/walkthrough/6-release-branch.md @@ -14,11 +14,9 @@ __Maintainers__ Bring your local develop branch up to date with the source repository: ```sh -$ git fetch source - $ git checkout develop -$ git merge source/develop +$ git pull ``` Create a new branch off of `develop` named `release-1.1`: @@ -46,17 +44,9 @@ __Maintainers__ Choose a maintainer to publish the release branch to the source repository: ```sh -$ git push source release-1.1 +$ git push -u origin HEAD ``` -### 3 - Open Pull Request - -__Maintainers__ - -Choose a maintainer to open a pull request to merge the release branch into the `master` branch. __Do not merge the pull request at this time__. - -This pull request is a good place to document all of the changes that comprise the release, perform a final review of the code that will be pushed, and comment on any issues related to the release. - ## Next Next we will walk through the process of fixing bugs in the release branch. diff --git a/walkthrough/7-release-bugs.md b/walkthrough/7-release-bugs.md index 984fe91a..a45813ab 100644 --- a/walkthrough/7-release-bugs.md +++ b/walkthrough/7-release-bugs.md @@ -14,15 +14,15 @@ Follow along with the activities below to walk through the process of fixing iss __Developers__ -Fetch the latest from source and create a local tracking branch for the release: +Fetch the latest from origin and create a local tracking branch for the release: ```sh -$ git fetch source -# fetch latest from source +$ git fetch origin +# fetch latest from origin $ git checkout release-1.1 # checkout the release branch -Branch hotfix-1.1 set up to track remote branch release-1.1 from source. +Branch hotfix-1.1 set up to track remote branch release-1.1 from origin. Switched to a new branch 'hotfix-1.0.1' ``` @@ -56,7 +56,7 @@ __Developers__ The two developers from the last step should now publish their feature branches to GitHub and open up Pull Requests against the `release-1.1` branch in the source repository: ```sh -$ git push origin FEATURE-BRANCH-NAME +$ git push -u me HEAD ``` --- diff --git a/walkthrough/8-completed-release.md b/walkthrough/8-completed-release.md index 4cf12f55..3868d58d 100644 --- a/walkthrough/8-completed-release.md +++ b/walkthrough/8-completed-release.md @@ -12,7 +12,21 @@ It is the last day of the month and no more requests have come in from the, time __Maintainers__ -Choose a maintainer to accept & merge the request to merge `release-1.1` into `master`. +Choose a maintainer to merge `release-1.1` into `master`. + +```sh +$ git checkout release-1.1 + +$ git pull + +$ git checkout master + +$ git pull + +$ git merge --no-ff release-1.1 + +$ git push +``` --- @@ -29,20 +43,12 @@ __Maintainers__ Next we will work to get changes made to the release merged back down into `develop`, so switch to the release branch and pull down all the latest changes: ```sh $ git checkout release-1.1 -# switch to release branch - -$ git pull -# pull latest changes -``` - -:bulb: Running git pull on a tracking branch will automatically fetch and merge changes. -Merge the release into develop, creating a new merge commit (via `--no-ff`): -```sh $ git checkout develop -# switch to develop -$ git merge release-1.1 --no-ff -m "Merging 1.1" +$ git merge --no-ff release-1.1 + +$ git push ``` :bulb: Always make sure that `develop` is up to date before merging. There may be some merge conflicts that will need to be addressed at this point. From af6dfba758b8d122100c2252cc90544c17b1c4ad Mon Sep 17 00:00:00 2001 From: Russ Ferri Date: Thu, 14 Jun 2018 11:39:34 -0400 Subject: [PATCH 16/21] Remove unneeded git checkout step --- walkthrough/2-feature-branches.md | 11 ----------- 1 file changed, 11 deletions(-) diff --git a/walkthrough/2-feature-branches.md b/walkthrough/2-feature-branches.md index 255f6641..16f54546 100644 --- a/walkthrough/2-feature-branches.md +++ b/walkthrough/2-feature-branches.md @@ -37,17 +37,6 @@ $ git branch :bulb: Feature branches will be named such that someone else can look at what branches are in progress and get a rough idea of what work is being done on each branch. -Next, switch to the newly created feature branch: -```sh -$ git checkout cuba-pudding-jr-feb -Switched to branch 'cuba-pudding-jr-feb' - -$ git branch -* cuba-pudding-jr-feb - develop - master -``` - :bulb: You can create a branch without immediately checking out the branch via the `git branch` command: ```sh $ git branch cuba-pudding-jr-feb From 3b874aeb82e77571884a6d50c4075157737f5811 Mon Sep 17 00:00:00 2001 From: Russell Ferri Date: Thu, 14 Jun 2018 15:28:15 -0400 Subject: [PATCH 17/21] Correct missed source => origin remote rename Previously `source` was the name of the remote for the shared code. The current version of the exercise uses `origin`. --- walkthrough/5-hotfix.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/walkthrough/5-hotfix.md b/walkthrough/5-hotfix.md index 9aaf5ce7..88182081 100644 --- a/walkthrough/5-hotfix.md +++ b/walkthrough/5-hotfix.md @@ -51,7 +51,7 @@ $ git commit -m "Bump version to 1.0.1" __Maintainers__ -Choose a maintainer to publish the hotfix branch. This maintainer should push the branch to source: +Choose a maintainer to publish the hotfix branch. This maintainer should push the branch to origin: ```sh $ git push -u origin HEAD @@ -69,15 +69,15 @@ $ git push -u origin HEAD __Developers__ -Fetch the latest from source and create a local tracking branch for the hotfix: +Fetch the latest from origin and create a local tracking branch for the hotfix: ```sh -$ git fetch source -# fetch latest from source +$ git fetch origin +# fetch latest from origin $ git checkout hotfix-1.0.1 # checkout the hotfix branch -Branch hotfix-1.0.1 set up to track remote branch hotfix-1.0.1 from source. +Branch hotfix-1.0.1 set up to track remote branch hotfix-1.0.1 from origin. Switched to a new branch 'hotfix-1.0.1' ``` @@ -163,7 +163,7 @@ $ git merge --no-ff hotfix-1.0.1 :bulb: Always make sure that `develop` is up to date before merging. There may be some merge conflicts that will need to be addressed at this point. -Push the commit up to the source repository: +Push the commit up to the origin repository: ```sh $ git push ``` From a995a379e5a6c0c668eca612514c8d15b16e92f0 Mon Sep 17 00:00:00 2001 From: kenyeo999 Date: Mon, 29 Mar 2021 15:06:08 +0800 Subject: [PATCH 18/21] Adding Madame Croque Feb Recipe --- app/index.md | 2 +- app/recipe/feb/madame-croque-feb.md | 34 +++++++++++++++++++++++++++++ app/writer/madame-croque.md | 2 ++ 3 files changed, 37 insertions(+), 1 deletion(-) create mode 100644 app/recipe/feb/madame-croque-feb.md diff --git a/app/index.md b/app/index.md index 60586822..3e63eed1 100644 --- a/app/index.md +++ b/app/index.md @@ -20,4 +20,4 @@ Welcome to _Flavor_, the only place on the planet where your taste buds won't be ### [Madame Croque](writer/madame-croque.md) | mmecroque@flavor.magazine -[Chocolate Soup](recipe/jan/chocolate-soup.md) +[Roast Pork and Pickled Cucumber Sandwich](../recipe/feb/madame-croque-feb.md) diff --git a/app/recipe/feb/madame-croque-feb.md b/app/recipe/feb/madame-croque-feb.md new file mode 100644 index 00000000..808b47c4 --- /dev/null +++ b/app/recipe/feb/madame-croque-feb.md @@ -0,0 +1,34 @@ +# Roast Pork and Pickled Cucumber Sandwich + +The best roast pork you'll ever eat! + +Source: https://www.realsimple.com/food-recipes/browse-all-recipes/roast-pork-sandwich + +## Ingredients + +- IngredientsIngredient Checklist + +- 1 pound boneless pork loin + +- ½ teaspoon cayenne pepper + +kosher salt and black pepper + +- 1 cucumber, thinly sliced + +- 3 tablespoons cider vinegar + +- 2 tablespoons olive oil + +- 2 teaspoons brown sugar + +- ⅓ cup mayonnaise + +- 4 Portuguese rolls, split + +# Instructions + +1. Heat oven to 450° F. Season the pork with the cayenne and ¼ teaspoon salt. Roast on a rimmed baking sheet until an instant-read thermometer inserted in the center reaches 145° F, 20 to 25 minutes; thinly slice. +2. Meanwhile, combine the cucumber, vinegar, oil, brown sugar, and ¼ teaspoon each salt and black pepper in a medium bowl. +3. Divide the mayonnaise, pork, and cucumber among the rolls. + diff --git a/app/writer/madame-croque.md b/app/writer/madame-croque.md index 68c5fbe8..9bcfd8ac 100644 --- a/app/writer/madame-croque.md +++ b/app/writer/madame-croque.md @@ -5,3 +5,5 @@ Recipe Picks: - January: [Chocolate Soup](../recipe/jan/chocolate-soup.md) +- February: [Roast Pork and Pickled Cucumber Sandwich](../recipe/feb/madame-croque-feb.md) + From 5feab8057a8aeecd409b16923814581daa3a5785 Mon Sep 17 00:00:00 2001 From: mdzakri Date: Mon, 29 Mar 2021 15:09:04 +0800 Subject: [PATCH 19/21] Adding John Lemon Feb Recipe --- app/index.md | 2 +- app/recipe/feb/john-lemon.md | 20 ++++++++++++++++++++ app/writer/john-lemon.md | 1 + 3 files changed, 22 insertions(+), 1 deletion(-) create mode 100644 app/recipe/feb/john-lemon.md diff --git a/app/index.md b/app/index.md index 60586822..95f812a3 100644 --- a/app/index.md +++ b/app/index.md @@ -16,7 +16,7 @@ Welcome to _Flavor_, the only place on the planet where your taste buds won't be ### [John Lemon](writer/john-lemon.md) | zestmaster@flavor.magazine -[Homemade Sausages](recipe/jan/homemade-sausages.md) +[John Lemon](recipe/feb/john-lemon.md) ### [Madame Croque](writer/madame-croque.md) | mmecroque@flavor.magazine diff --git a/app/recipe/feb/john-lemon.md b/app/recipe/feb/john-lemon.md new file mode 100644 index 00000000..dee6c938 --- /dev/null +++ b/app/recipe/feb/john-lemon.md @@ -0,0 +1,20 @@ +# Candied Carrots + +My family's favorite vegetable. They are great for the holidays, too! + +Source: https://www.allrecipes.com/recipe/18241/candied-carrots/ + +## Ingredients + +- 1 pound carrots, cut into 2 inch pieces +- 2 tablespoons butter, diced +- ¼ cup packed brown sugar +- 1 pinch salt +- 1 pinch ground black pepper + + +## Instructions + +1. Place carrots in a pot of salted water. Bring water to a boil, reduce heat to a high simmer and cook about 20 to 30 minutes. Do not cook the carrots to a mushy stage! +2. Drain the carrots, reduce the heat to its lowest possible setting and return the carrots to the pan. Stir in butter, brown sugar, salt and pepper. Cook for about 3 to 5 minutes, until sugar is bubbly. Serve hot! + diff --git a/app/writer/john-lemon.md b/app/writer/john-lemon.md index 97b2ce12..5a49a15c 100644 --- a/app/writer/john-lemon.md +++ b/app/writer/john-lemon.md @@ -5,3 +5,4 @@ Recipe Picks: - January: [Homemade Sausages](../recipe/jan/homemade-sausages.md) +- Febuary: [John Lemon](../recipe/feb/john-lemon.md) \ No newline at end of file From d295941f401758580c9e49dc3c188e71bbeaa097 Mon Sep 17 00:00:00 2001 From: zhafurry <81541055+zhafurry@users.noreply.github.com> Date: Mon, 29 Mar 2021 15:10:23 +0800 Subject: [PATCH 20/21] Adding Cuba Pudding Jr.'s Feb Recipe --- app/index.md | 2 +- app/recipe/feb/oatmeal-pancakes.md | 43 ++++++++++++++++++++++++++++++ app/writer/cuba-pudding-jr.md | 2 ++ 3 files changed, 46 insertions(+), 1 deletion(-) create mode 100644 app/recipe/feb/oatmeal-pancakes.md diff --git a/app/index.md b/app/index.md index 60586822..b1d971bd 100644 --- a/app/index.md +++ b/app/index.md @@ -8,7 +8,7 @@ Welcome to _Flavor_, the only place on the planet where your taste buds won't be ### [Cuba Pudding Jr.](writer/cuba-pudding-jr.md) | cubapud@flavor.magazine -[Grilled Peach Salad](recipe/jan/grilled-peach-salad.md) +[Grilled Peach Salad](recipe/feb/oatmeal-pancakes.md) ### [Eggs Benny](writer/eggs-benny.md) | englishmuffin@flavor.magazine diff --git a/app/recipe/feb/oatmeal-pancakes.md b/app/recipe/feb/oatmeal-pancakes.md new file mode 100644 index 00000000..1b348370 --- /dev/null +++ b/app/recipe/feb/oatmeal-pancakes.md @@ -0,0 +1,43 @@ +# Recipe Title + +A short recipe description. + +Source: https://www.allrecipes.com/recipe/228654/quick-oatmeal-pancakes/ + +## Ingredients + +- 1 cup milk + +- ⅔ cup quick-cooking oats + +- ⅔ cup all-purpose flour + +- 2 tablespoons brown sugar + +- 1 ½ teaspoons baking powder + +- ½ teaspoon salt + +- ¼ teaspoon ground cinnamon + +- 2 eggs + +- 2 teaspoons butter, melted + +- ½ teaspoon vanilla extract + +- ¼ cup milk, or more as needed + +- 2 teaspoons butter, or as needed + + +# Instructions + +Step 1 +Place 1 cup milk in a microwave-safe bowl; heat in microwave until bubbling, about 2 minutes. Stir in the oats. + +Step 2 +Mix flour, brown sugar, baking powder, salt, and cinnamon together in a bowl. Whisk eggs, 2 teaspoons melted butter, and vanilla extract together in a separate bowl; add 1/4 cup milk. Mix oat mixture and egg mixture with flour mixture; stir to combine. + +Step 3 +Heat 2 teaspoons butter on a griddle or skillet over medium heat; pour about 1/3 cup batter into the hot butter. Cook pancakes until bubbles appear on top layer, about 5 minutes. Flip and cook other side until evenly browned, about 5 more minutes. diff --git a/app/writer/cuba-pudding-jr.md b/app/writer/cuba-pudding-jr.md index dc2bfe39..d25bc6d3 100644 --- a/app/writer/cuba-pudding-jr.md +++ b/app/writer/cuba-pudding-jr.md @@ -5,3 +5,5 @@ Recipe Picks: - January: [Grilled Peach Salad](../recipe/jan/grilled-peach-salad.md) +- February: [Oatmeal Pancakes](../recipe/feb/oatmeal-pancakes.md) + From 0d6524523ef6ac7463c3bf8734f54cb2c17a0599 Mon Sep 17 00:00:00 2001 From: JT Date: Mon, 29 Mar 2021 15:10:26 +0800 Subject: [PATCH 21/21] Adding Egg Benny's Feb Recipe --- app/index.md | 2 +- app/recipe/feb/egg-benny.md | 19 +++++++++++++++++++ app/writer/eggs-benny.md | 2 ++ 3 files changed, 22 insertions(+), 1 deletion(-) create mode 100644 app/recipe/feb/egg-benny.md diff --git a/app/index.md b/app/index.md index 60586822..68a37c31 100644 --- a/app/index.md +++ b/app/index.md @@ -12,7 +12,7 @@ Welcome to _Flavor_, the only place on the planet where your taste buds won't be ### [Eggs Benny](writer/eggs-benny.md) | englishmuffin@flavor.magazine -[Vanilla Panna Cotta](recipe/jan/vanilla-panna-cotta.md) +[Egg Benny](recipe/feb/egg-benny.md) ### [John Lemon](writer/john-lemon.md) | zestmaster@flavor.magazine diff --git a/app/recipe/feb/egg-benny.md b/app/recipe/feb/egg-benny.md new file mode 100644 index 00000000..ef7f25bd --- /dev/null +++ b/app/recipe/feb/egg-benny.md @@ -0,0 +1,19 @@ +#Egg Benny + +A short recipe description. + +Source: https://example.com/link/to/original/recipe/ + +## Ingredients + +- Egg +- Pine nuts +- dried cranberries +- Salt + + +# Instructions + +1. Break off or trim the woody ends from the asparagus and discard. Set the spears aside. +2. Heat the olive oil in a skillet over medium heat. Stir in the pine nuts, cranberries, and salt. Cook and stir until the pine nuts start to look translucent, 5 to 6 minutes. Add the asparagus spears and cook, adding a little more olive oil if needed, until stalks are bright green and tender, about 5 to 8 minutes. Serve on a platter with the cranberries and nuts spooned over the top of the asparagus. + diff --git a/app/writer/eggs-benny.md b/app/writer/eggs-benny.md index 18d7bb16..c25d4ebb 100644 --- a/app/writer/eggs-benny.md +++ b/app/writer/eggs-benny.md @@ -5,3 +5,5 @@ Recipe Picks: - January: [Vanilla Panna Cotta](../recipe/jan/vanilla-panna-cotta.md) +- Febuary: [Egg Benny](../recipe/feb/egg-benny.md) +