setup guides generated

Author: github-actions

LINUX.es.md

@@ -476,7 +476,7 @@ rm -rf ~/.anaconda_backup
     - Guarda el archivo con `CTRL` + `s`
 - Reinicia la terminal con `exec zsh`
 - Remueve la inicializaciópn de Anaconda de tu `.zshrc`:
-    - Abre el archivo con `code ~/.zshrc`
+    - Abre el archivo con `code ~/.zshrc` 
     - Remueve las líneas de código desde `>>> conda initialize >>>` hasta `<<< conda initialize <<<`
 </details>
 
@@ -680,7 +680,7 @@ Debería aparecer el siguiente mensaje:
 ![](images/docker_hello.png)
 
 
-## Kitt
+  ## Kitt
 
 Deberías haber recibido un correo electrónico de Le Wagon invitándote a registrarte en [Kitt](https://kitt.lewagon.com) (nuestra plataforma de aprendizaje).
 
@@ -735,3 +735,5 @@ Si has terminado la configuración, te pedimos que preguntes si alguien necesita
 Si no tienes mucha experiencia con `git` y GitHub, por favor [ve nuevamente el video de este workshop](https://www.youtube.com/watch?v=Z9fIBT2NBGY) (puedes verlo a `1.25` de velocidad).
 
 Si aún te queda tiempo, puedes esperar trabajar en este [Kata de Tic-Tac-Toe](https://www.codewars.com/kata/5b817c2a0ce070ace8002be0/python) mientras esperas la primera clase.
+
+

LINUX.md

@@ -491,7 +491,7 @@ rm -rf ~/.anaconda_backup
     - Save the file with `CTRL` + `s`
 - Restart your terminal with `exec zsh`
 - Remove Anaconda initialization from your `.zshrc`:
-    - Open the file with `code ~/.zshrc`
+    - Open the file with `code ~/.zshrc` 
     - Remove the code lines starting from `>>> conda initialize >>>` to `<<< conda initialize <<<`
 </details>
 
@@ -716,7 +716,7 @@ The following message should print:
 ![](images/docker_hello.png)
 
 
-## Kitt
+  ## Kitt
 
 You should have received an email from Le Wagon inviting you to sign up on [Kitt](https://kitt.lewagon.com) (our learning platform).
 
@@ -770,3 +770,5 @@ If you are done with your setup, please ask around if some classmates need some
 If you don't have a lot of experience with `git` and GitHub, please [(re-)watch this workshop](https://www.youtube.com/watch?v=Z9fIBT2NBGY) (`1.25` playback speed is fine).
 
 If you do, then you can wait for the first lecture working on this [Tic-Tac-Toe Kata](https://www.codewars.com/kata/5b817c2a0ce070ace8002be0/python)
+
+

LINUX_gcp.md

@@ -175,24 +175,57 @@ Since the [service account](https://cloud.google.com/iam/docs/service-accounts)
 
 ⚠️ **Do not share you service account json file 🔑** ⚠️ Do not store it on your desktop, do not store it in your git codebase (even if your git repository is private), do not let it by the coffee machine, do not send it as a tweet.
 
-- Go to the [service accounts page](https://console.cloud.google.com/apis/credentials/serviceaccountkey)
-- Select your project in the list of recent projects if asked to
-- Create a service account:
-  - Click on **CREATE SERVICE ACCOUNT**:
-  - Give a `Service account name` to that account
-  - Click on **CREATE AND CONTINUE**
-  - Click on **Select a role** and choose `Quick access/Basic` then **Owner**, which gives full access to all resources
-  - Click on **CONTINUE**
-  - Click on **DONE**
-- Download the service account json file 🔑:
-  - Click on the newly created service account
-  - Click on **KEYS**
-  - Click on **ADD KEY** then **Create new key**
-  - Select **JSON** and click on **CREATE**
-
-![](images/gcp_create_key.png)
-
-The browser has now saved the service account json file 🔑 in your downloads directory (it is named according to your service account name, something like `le-wagon-data-123456789abc.json`)
+#### Go to the Service Accounts page
+
+Navigate to the GCP service accounts page at [this link](https://console.cloud.google.com/apis/credentials/serviceaccountkey).
+
+- Select your project in the list of recent projects if asked to.
+- If not asked, make sure the right project is selected in the Project selecter list at the top of the page.
+
+An alternate way to navigate to the Service Accounts page is from the following:
+
+<img width="400" alt="01 Go to Service Accounts" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-01.png">
+
+#### Create a service account
+
+- Click on **CREATE SERVICE ACCOUNT**.
+
+  <img width="400" alt="02 Create Service Account" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-02.png">
+
+- Give your service account a name, an id and a description, and click on **CREATE AND CONTINUE**.
+
+  <img width="400" alt="03 Name the service account" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-03.png">
+
+- Click on **Select a role** and choose `Basic` then **`Owner`**, which gives the service account full access to all resources of your GCP project.
+
+  <img width="400" alt="04 Add BigQuery Job User" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-04.png">
+
+- Click on the blue **DONE** button at the bottom of this window. We don't need to worry about the section *Grant your users access to this service account*.
+
+  <img width="400" alt="04 Done" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-05.png">
+
+
+#### Create a json key 🔑 for this service account
+
+- On the service accounts page, click on the email address of the newly created service account.
+
+  <img width="400" alt="05 Select the service account" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-06.png">
+
+- Click on the **KEYS** tab at the top of the page.
+
+  <img width="400" alt="06 Go to Keys" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-07.png">
+
+
+- Click on **ADD KEY** then **Create new key**.
+
+  <img width="400" alt="07 Add Key" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-08.png">
+
+
+- Select **JSON** and click on **CREATE**.
+
+  <img width="400" alt="08 Choose JSON and Create" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-09.png">
+
+- The browser has now saved the service account json file 🔑 in your downloads directory (it is named according to your service account name, something like `le-wagon-data-123456789abc.json`).
 
 
 - Store the service account json file somewhere you'll remember, for example:

WINDOWS.es.md

@@ -953,7 +953,7 @@ rm -rf ~/.anaconda_backup
     - Si el archivo abre, busca la línea que coincida con el siguiente patrón `export PATH="/path/to/anaconda3/bin:$PATH"` y eliminala
 - Reinicia la terminal con `exec zsh`
 - Remueve la inicializaciópn de Anaconda de tu `.zshrc`:
-    - Abre el archivo con `code ~/.zshrc`
+    - Abre el archivo con `code ~/.zshrc` 
     - Remueve las líneas de código desde `>>> conda initialize >>>` hasta `<<< conda initialize <<<`
 </details>
 
@@ -1291,7 +1291,7 @@ Intente `docker info` nuevamente.
 </details>
 
 
-## Kitt
+  ## Kitt
 
 Deberías haber recibido un correo electrónico de Le Wagon invitándote a registrarte en [Kitt](https://kitt.lewagon.com) (nuestra plataforma de aprendizaje).
 
@@ -1346,3 +1346,5 @@ Si has terminado la configuración, te pedimos que preguntes si alguien necesita
 Si no tienes mucha experiencia con `git` y GitHub, por favor [ve nuevamente el video de este workshop](https://www.youtube.com/watch?v=Z9fIBT2NBGY) (puedes verlo a `1.25` de velocidad).
 
 Si aún te queda tiempo, puedes esperar trabajar en este [Kata de Tic-Tac-Toe](https://www.codewars.com/kata/5b817c2a0ce070ace8002be0/python) mientras esperas la primera clase.
+
+

WINDOWS.md

@@ -958,7 +958,7 @@ rm -rf ~/.anaconda_backup
     - If the file opens find the line matching the following pattern `export PATH="/path/to/anaconda3/bin:$PATH"` and delete the line
 - Restart your terminal with `exec zsh`
 - Remove Anaconda initialization from your `.zshrc`:
-    - Open the file with `code ~/.zshrc`
+    - Open the file with `code ~/.zshrc` 
     - Remove the code lines starting from `>>> conda initialize >>>` to `<<< conda initialize <<<`
 </details>
 
@@ -1315,7 +1315,7 @@ Try `docker run hello-world` again.
 </details>
 
 
-## Kitt
+  ## Kitt
 
 You should have received an email from Le Wagon inviting you to sign up on [Kitt](https://kitt.lewagon.com) (our learning platform).
 
@@ -1369,3 +1369,5 @@ If you are done with your setup, please ask around if some classmates need some
 If you don't have a lot of experience with `git` and GitHub, please [(re-)watch this workshop](https://www.youtube.com/watch?v=Z9fIBT2NBGY) (`1.25` playback speed is fine).
 
 If you do, then you can wait for the first lecture working on this [Tic-Tac-Toe Kata](https://www.codewars.com/kata/5b817c2a0ce070ace8002be0/python)
+
+

WINDOWS_gcp.md

@@ -175,24 +175,57 @@ Since the [service account](https://cloud.google.com/iam/docs/service-accounts)
 
 ⚠️ **Do not share you service account json file 🔑** ⚠️ Do not store it on your desktop, do not store it in your git codebase (even if your git repository is private), do not let it by the coffee machine, do not send it as a tweet.
 
-- Go to the [service accounts page](https://console.cloud.google.com/apis/credentials/serviceaccountkey)
-- Select your project in the list of recent projects if asked to
-- Create a service account:
-  - Click on **CREATE SERVICE ACCOUNT**:
-  - Give a `Service account name` to that account
-  - Click on **CREATE AND CONTINUE**
-  - Click on **Select a role** and choose `Quick access/Basic` then **Owner**, which gives full access to all resources
-  - Click on **CONTINUE**
-  - Click on **DONE**
-- Download the service account json file 🔑:
-  - Click on the newly created service account
-  - Click on **KEYS**
-  - Click on **ADD KEY** then **Create new key**
-  - Select **JSON** and click on **CREATE**
-
-![](images/gcp_create_key.png)
-
-The browser has now saved the service account json file 🔑 in your downloads directory (it is named according to your service account name, something like `le-wagon-data-123456789abc.json`)
+#### Go to the Service Accounts page
+
+Navigate to the GCP service accounts page at [this link](https://console.cloud.google.com/apis/credentials/serviceaccountkey).
+
+- Select your project in the list of recent projects if asked to.
+- If not asked, make sure the right project is selected in the Project selecter list at the top of the page.
+
+An alternate way to navigate to the Service Accounts page is from the following:
+
+<img width="400" alt="01 Go to Service Accounts" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-01.png">
+
+#### Create a service account
+
+- Click on **CREATE SERVICE ACCOUNT**.
+
+  <img width="400" alt="02 Create Service Account" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-02.png">
+
+- Give your service account a name, an id and a description, and click on **CREATE AND CONTINUE**.
+
+  <img width="400" alt="03 Name the service account" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-03.png">
+
+- Click on **Select a role** and choose `Basic` then **`Owner`**, which gives the service account full access to all resources of your GCP project.
+
+  <img width="400" alt="04 Add BigQuery Job User" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-04.png">
+
+- Click on the blue **DONE** button at the bottom of this window. We don't need to worry about the section *Grant your users access to this service account*.
+
+  <img width="400" alt="04 Done" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-05.png">
+
+
+#### Create a json key 🔑 for this service account
+
+- On the service accounts page, click on the email address of the newly created service account.
+
+  <img width="400" alt="05 Select the service account" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-06.png">
+
+- Click on the **KEYS** tab at the top of the page.
+
+  <img width="400" alt="06 Go to Keys" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-07.png">
+
+
+- Click on **ADD KEY** then **Create new key**.
+
+  <img width="400" alt="07 Add Key" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-08.png">
+
+
+- Select **JSON** and click on **CREATE**.
+
+  <img width="400" alt="08 Choose JSON and Create" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-09.png">
+
+- The browser has now saved the service account json file 🔑 in your downloads directory (it is named according to your service account name, something like `le-wagon-data-123456789abc.json`).
 
 
 We will now move the service account json file from your Windows disk to the Ubuntu disk. This will allow the development tools in Ubuntu to access to the resources of your GCP account.

macOS.es.md

@@ -528,7 +528,7 @@ rm -rf ~/opt
     - Guarda el archivo con `CMD` + `s`
 - Reinicia la terminal con `exec zsh`
 - Remueve la inicializaciópn de Anaconda de tu `.zshrc`:
-    - Abre el archivo con `code ~/.zshrc`
+    - Abre el archivo con `code ~/.zshrc` 
     - Remueve las líneas de código desde `>>> conda initialize >>>` hasta `<<< conda initialize <<<`
 </details>
 
@@ -793,7 +793,7 @@ $(brew --prefix)/Caskroom/google-cloud-sdk/latest/google-cloud-sdk/install.sh
 ```
 
 
-## Kitt
+  ## Kitt
 
 Deberías haber recibido un correo electrónico de Le Wagon invitándote a registrarte en [Kitt](https://kitt.lewagon.com) (nuestra plataforma de aprendizaje).
 
@@ -896,3 +896,5 @@ Si has terminado la configuración, te pedimos que preguntes si alguien necesita
 Si no tienes mucha experiencia con `git` y GitHub, por favor [ve nuevamente el video de este workshop](https://www.youtube.com/watch?v=Z9fIBT2NBGY) (puedes verlo a `1.25` de velocidad).
 
 Si aún te queda tiempo, puedes esperar trabajar en este [Kata de Tic-Tac-Toe](https://www.codewars.com/kata/5b817c2a0ce070ace8002be0/python) mientras esperas la primera clase.
+
+

macOS.md

@@ -525,7 +525,7 @@ rm -rf ~/opt
     - Save the file with `CMD` + `s`
 - Restart your terminal with `exec zsh`
 - Remove Anaconda initialization from your `.zshrc`:
-    - Open the file with `code ~/.zshrc`
+    - Open the file with `code ~/.zshrc` 
     - Remove the code lines starting from `>>> conda initialize >>>` to `<<< conda initialize <<<`
 </details>
 
@@ -810,7 +810,7 @@ $(brew --prefix)/Caskroom/google-cloud-sdk/latest/google-cloud-sdk/install.sh
 ```
 
 
-## Kitt
+  ## Kitt
 
 You should have received an email from Le Wagon inviting you to sign up on [Kitt](https://kitt.lewagon.com) (our learning platform).
 
@@ -912,3 +912,5 @@ If you are done with your setup, please ask around if some classmates need some
 If you don't have a lot of experience with `git` and GitHub, please [(re-)watch this workshop](https://www.youtube.com/watch?v=Z9fIBT2NBGY) (`1.25` playback speed is fine).
 
 If you do, then you can wait for the first lecture working on this [Tic-Tac-Toe Kata](https://www.codewars.com/kata/5b817c2a0ce070ace8002be0/python)
+
+

macOS_gcp.md

@@ -175,24 +175,57 @@ Since the [service account](https://cloud.google.com/iam/docs/service-accounts)
 
 ⚠️ **Do not share you service account json file 🔑** ⚠️ Do not store it on your desktop, do not store it in your git codebase (even if your git repository is private), do not let it by the coffee machine, do not send it as a tweet.
 
-- Go to the [service accounts page](https://console.cloud.google.com/apis/credentials/serviceaccountkey)
-- Select your project in the list of recent projects if asked to
-- Create a service account:
-  - Click on **CREATE SERVICE ACCOUNT**:
-  - Give a `Service account name` to that account
-  - Click on **CREATE AND CONTINUE**
-  - Click on **Select a role** and choose `Quick access/Basic` then **Owner**, which gives full access to all resources
-  - Click on **CONTINUE**
-  - Click on **DONE**
-- Download the service account json file 🔑:
-  - Click on the newly created service account
-  - Click on **KEYS**
-  - Click on **ADD KEY** then **Create new key**
-  - Select **JSON** and click on **CREATE**
-
-![](images/gcp_create_key.png)
-
-The browser has now saved the service account json file 🔑 in your downloads directory (it is named according to your service account name, something like `le-wagon-data-123456789abc.json`)
+#### Go to the Service Accounts page
+
+Navigate to the GCP service accounts page at [this link](https://console.cloud.google.com/apis/credentials/serviceaccountkey).
+
+- Select your project in the list of recent projects if asked to.
+- If not asked, make sure the right project is selected in the Project selecter list at the top of the page.
+
+An alternate way to navigate to the Service Accounts page is from the following:
+
+<img width="400" alt="01 Go to Service Accounts" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-01.png">
+
+#### Create a service account
+
+- Click on **CREATE SERVICE ACCOUNT**.
+
+  <img width="400" alt="02 Create Service Account" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-02.png">
+
+- Give your service account a name, an id and a description, and click on **CREATE AND CONTINUE**.
+
+  <img width="400" alt="03 Name the service account" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-03.png">
+
+- Click on **Select a role** and choose `Basic` then **`Owner`**, which gives the service account full access to all resources of your GCP project.
+
+  <img width="400" alt="04 Add BigQuery Job User" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-04.png">
+
+- Click on the blue **DONE** button at the bottom of this window. We don't need to worry about the section *Grant your users access to this service account*.
+
+  <img width="400" alt="04 Done" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-05.png">
+
+
+#### Create a json key 🔑 for this service account
+
+- On the service accounts page, click on the email address of the newly created service account.
+
+  <img width="400" alt="05 Select the service account" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-06.png">
+
+- Click on the **KEYS** tab at the top of the page.
+
+  <img width="400" alt="06 Go to Keys" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-07.png">
+
+
+- Click on **ADD KEY** then **Create new key**.
+
+  <img width="400" alt="07 Add Key" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-08.png">
+
+
+- Select **JSON** and click on **CREATE**.
+
+  <img width="400" alt="08 Choose JSON and Create" src="https://wagon-public-datasets.s3.amazonaws.com/data-science-images/00-Setup/GCP/service-account-09.png">
+
+- The browser has now saved the service account json file 🔑 in your downloads directory (it is named according to your service account name, something like `le-wagon-data-123456789abc.json`).
 
 
 - Store the service account json file somewhere you'll remember, for example: