github cloning

Author: jonathanneo

content/_index.md

@@ -20,5 +20,6 @@ The next few tasks will take you through setting up and getting ready for day 1.
 | 03 | [Install PostgreSQL](./docs/3-install-postgresql) | 
 | 04 | [Install git](./docs/4-install-git) | 
 | 05 | [Setup GitHub](./docs/5-setup-github) | 
-| 06 | [Prepare your introduction presentation](./docs/6-intro-presentation) | 
-| 07 | [Learning resources](./docs/7-learning-resources) | 
+| 06 | [Clone GitHub Repository](./docs/6-clone-github-repository) | 
+| 07 | [Prepare your introduction presentation](./docs/7-intro-presentation) | 
+| 08 | [Learning resources](./docs/8-learning-resources) | 

content/docs/5-setup-github.md

@@ -26,4 +26,8 @@ To get your GitHub username:
 2. In the address bar, you should see `github.com/your_username_should_appear_here`.
 3. Copy the username value and submit via the form.
 
-{{< button relref="/docs/4-install-git" >}}&laquo; Previous{{< /button >}} {{< button relref="/docs/6-intro-presentation" >}}Next &raquo;{{< /button >}}
+We'll periodically check the github usernames and add grant new usernames access to the github repository. So please give up to 2 business days for this to take place. 
+
+You will receive an email from Github once you have been granted access. 
+
+{{< button relref="/docs/4-install-git" >}}&laquo; Previous{{< /button >}} {{< button relref="/docs/6-clone-github-repository" >}}Next &raquo;{{< /button >}}

content/docs/6-clone-github-repository.md

@@ -0,0 +1,60 @@
+---
+weight: 1
+bookFlatSection: true
+title: "6. Clone GitHub Repository"
+---
+
+# Clone GitHub Repository
+
+Once you have read access to the course repository, you would need to clone the repository to your local machine.
+
+Before we can do that, we need to setup your local machine's authentication with Github.
+
+There are many ways to do this.
+
+## GitHub Authentication Option 1: SSH
+
+Follow the official docs to setup SSH authentication:
+
+1. https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent
+2. https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account
+
+Using SSH keys is the preferred method by most companies in the industry as it is more secure by making use of public key cryptography. It would be a good chance for you to learn how to do this if you haven't before.
+
+The idea is that you would upload a "public" key to Github and you keep a "private" key in your machine. That means if you leak your public key, it is very difficult for an attacker to brute force and crack your private key (assuming you keep your private key safe and secure). At the time of writing, brute forcing a key of 4096 bits will take years that can even take longer than our lifetimes in this world.
+
+With this method, clone the repository using the ssh method:
+
+```sh
+$ git clone [email protected]:Data-Engineer-Camp/<yyyy><mm>-bootcamp.git
+```
+
+## GitHub Authentication Option 2: Personal access tokens
+
+Follow the official docs:
+
+1. https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens
+
+This is the simplest and easiest way to manage authentication with Github. However, you should treat your access tokens as passwords because if it gets leaked, an attacker would have full access to your account.
+
+This is the least preferred method, only do this if you are having issues with the previous option.
+
+With this method, clone the repository using the https method:
+
+```sh
+$ git clone https://github.com/Data-Engineer-Camp/<yyyy><mm>-bootcamp.git
+Username: YOUR_USERNAME
+Password: YOUR_PERSONAL_ACCESS_TOKEN
+```
+
+## Pulling updates from the repo
+
+After every lecture, we will be uploading the solved student solutions.
+
+To pull updates from the repository:
+
+```sh
+git pull origin main
+```
+
+{{< button relref="/docs/5-setup-github" >}}&laquo; Previous{{< /button >}} {{< button relref="/docs/7-intro-presentation" >}}Next &raquo;{{< /button >}}

content/docs/6-intro-presentation.md renamed to content/docs/7-intro-presentation.md

@@ -1,7 +1,7 @@
 ---
 weight: 1
 bookFlatSection: true
-title: "6. Prepare introduction presentation"
+title: "7. Prepare introduction presentation"
 ---
 
 # Intro presentation 
@@ -21,4 +21,4 @@ We encourage you to include photos and keep it fun!
 Check out a sample intro presentation [here](https://docs.google.com/presentation/d/1KGSesJoyvl1FqJQTwp1BRd4xpTkL2aeIezWZFFAC-Q4/edit?usp=sharing).
 
 
-{{< button relref="/docs/5-setup-github" >}}&laquo; Previous{{< /button >}} {{< button relref="/docs/7-learning-resources" >}}Next &raquo;{{< /button >}}
+{{< button relref="/docs/6-clone-github-repository" >}}&laquo; Previous{{< /button >}} {{< button relref="/docs/8-learning-resources" >}}Next &raquo;{{< /button >}}

content/docs/7-learning-resources.md renamed to content/docs/8-learning-resources.md

@@ -1,7 +1,7 @@
 ---
 weight: 1
 bookFlatSection: true
-title: "7. Learning Resources"
+title: "8. Learning Resources"
 ---
 
 # Python
@@ -26,5 +26,5 @@ You should be familiar with basic Command Line Interface (CLI) commands. If not,
 
 - [Command Line Interface basics](https://www.w3schools.com/whatis/whatis_cli.asp)
 
-{{< button relref="/docs/6-intro-presentation" >}}&laquo; Previous{{< /button >}}
+{{< button relref="/docs/7-intro-presentation" >}}&laquo; Previous{{< /button >}}
 

content/docs/_index.md

@@ -7,5 +7,6 @@ headless: true
 - [3. Install PostgreSQL]({{< relref "/docs/3-install-postgresql" >}})
 - [4. Install Git]({{< relref "/docs/4-install-git" >}})
 - [5. Setup GitHub]({{< relref "/docs/5-setup-github" >}})
-- [6. Prepare Intro Presentation]({{< relref "/docs/6-intro-presentation" >}})
-- [7. Learning Resources]({{< relref "/docs/7-learning-resources" >}})
+- [6. Clone GitHub Repository]({{< relref "/docs/6-clone-github-repository" >}})
+- [7. Prepare Intro Presentation]({{< relref "/docs/7-intro-presentation" >}})
+- [8. Learning Resources]({{< relref "/docs/8-learning-resources" >}})