Skip to content

Commit f6c9f80

Browse files
authored
Do an audit for clarity (#507)
We got some feedback that there were some unclear parts of the setup. I tried to edit it to make parts more explicit that I've seen students mess up. Also some of the settings names on Mac were out of date with the new OS. I had Claude check and update all our translations. In particular, we got feedback that the French version was out of date...and that did indeed seem to be true 🙈
1 parent 674ae5a commit f6c9f80

25 files changed

Lines changed: 78 additions & 90 deletions

_partials/cn/dotfiles.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -62,3 +62,5 @@ cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh
6262
exec zsh
6363
```
6464

65+
_这将重新加载你的shell,使其能够读取新的配置。_
66+

_partials/cn/gh_cli.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ CLI是[Command-line Interface(命令行界面)](https://baike.baidu.com/item
88

99
首先你需要**登陆**。复制粘贴下面的命令到终端,敲击回车:
1010

11-
:warning: **不要更改下面指令中的`email`**
11+
:warning: **不要更改下面指令中的`email`** — 尽管`user:email`看起来像是你真实邮件地址的占位符,但实际上并不是——请不要替换它。
1212

1313
```bash
1414
gh auth login -s 'user:email' -w --git-protocol ssh
@@ -20,7 +20,9 @@ gh auth login -s 'user:email' -w --git-protocol ssh
2020

2121
如果你以前生成过SSH密钥,那你就会看到这个问题`Upload your SSH public key to your GitHub account?(上传公共密钥到Github账户上上吗?)` 上下移动箭头`>`,让它停在你想选的SSH公钥前面,然后敲击回车。
2222

23-
- `Enter a passphrase for your new SSH key (Optional)(输入新的SSH密钥的密码(非必填))`. 输入一个密码,然后写下来或者记住它。这是保护你本地私钥的密码。然后敲击回车。
23+
- `Enter a passphrase for your new SSH key (Optional)(输入新的SSH密钥的密码(非必填))`:
24+
- **对大多数学生来说:** 直接按下`Enter`跳过即可。训练营中不需要密码,而且每次使用密钥时都会提示你输入。不过有一个风险,如果有人偷了你的电脑,他们就可以向GitHub推送代码。
25+
- **如果安全对你来说非常重要:** 输入一个你选择的密码,然后按`Enter`_非常_ 重要的是,如果你输入了密码,请立即把它记在某个地方,不要丢失或遗忘。你会经常需要输入它。
2426

2527
- `Title for your SSH key`。你可以把它留在建议的 "GitHub CLI",按`Enter`
2628

_partials/cn/macos_terminal.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,9 @@
11
## macOS Terminal Theme
22

3-
在Mac上,打开`Terminal > Preferences`并在`Profiles`中将Pro”主题设置为默认。
3+
在Mac上,打开`Terminal > Settings`并在`Profiles`中将Pro”主题设置为默认。
44

55
![为macOS终端设置Pro主题](images/macos_terminal_pro.png)
66

7+
在Window选项卡中,将**窗口大小**设置为列数:200,行数:50
8+
79
**退出**并重启终端。它现在会有一个好看的黑色背景,对眼睛会更友好。

_partials/dotfiles.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -75,3 +75,5 @@ Please now **reset** your terminal by running:
7575
```bash
7676
exec zsh
7777
```
78+
79+
_This reloads your shell so it picks up the new configuration._

_partials/es/dotfiles.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ gh api user/emails | jq -r '.[].email'
4343

4444
:heavy_check_mark: Si ves una lista de tus emails registrados, puedes continuar :+1:
4545

46-
:x: De lo contrario, por favor haz la [autenticación en GitHub](https://github.com/lewagon/setup/blob/master/<OS.md>#github-cli) nuevamente antes de ejecutar este comando :point_up: again.
46+
:x: De lo contrario, por favor haz la [autenticación en GitHub](https://github.com/lewagon/setup/blob/master/<OS.md>#github-cli) nuevamente antes de ejecutar este comando :point_up:.
4747

4848
### Instalación de git
4949

@@ -62,3 +62,5 @@ Ahora **resetea** tu terminal ejecutando lo siguiente:
6262
```bash
6363
exec zsh
6464
```
65+
66+
_Esto recarga tu shell para que tome la nueva configuración._

_partials/es/gh_cli.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ Ya debería haberse instalado en tu computadora con los comandos que ejecutaste
1010

1111
Lo primero que hay que hacer para **iniciar sesión** es copiar y pegar el comando siguiente en tu terminal:
1212

13-
:warning: **NO edites el `email`**
13+
:warning: **NO edites el `email`** — Aunque `user:email` parezca un marcador de posición para tu dirección de correo real, no lo es — no lo reemplaces.
1414

1515
```bash
1616
gh auth login -s 'user:email' -w --git-protocol ssh
@@ -22,7 +22,9 @@ gh auth login -s 'user:email' -w --git-protocol ssh
2222

2323
Si ya tienes claves SSH, verás en su lugar `Upload your SSH public key to your GitHub account?`Con las flechas, selecciona la ruta de tu archivo de clave pública y pulsa `Intro`.
2424

25-
- `Enter a passphrase for your new SSH key (Optional)`. Pon algo que quieras y que recuerdes. Es una contraseña para proteger tu private key que está almacenada en tu disco duro. Luego presiona `Enter`.
25+
- `Enter a passphrase for your new SSH key (Optional)`:
26+
- **PARA LA MAYORÍA DE LOS ESTUDIANTES:** Simplemente presiona `Enter` para omitir. No necesitas una contraseña para el bootcamp y te la pediría cada vez que uses la clave. Sin embargo, hay un riesgo de que si alguien roba tu computadora, pueda subir código a GitHub.
27+
- **SI LA SEGURIDAD ES MUY IMPORTANTE PARA TI:** Escribe una contraseña de tu elección y presiona `Enter`. Es _muy_ importante que si introduces una contraseña, la anotes en algún lugar inmediatamente y no la pierdas ni la olvides. Tendrás que introducirla con frecuencia.
2628

2729
- `Title for your SSH key`. Puede dejarlo en la propuesta "GitHub CLI", presiona `Enter`.
2830

_partials/es/macos_terminal.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
## Tema de la Terminal en macOS
22

3-
Abre una terminal. Haz clic en `Terminal > Preferences` y coloca el tema llamado "Pro" como perfil predeterminado.
3+
Abre una terminal. Haz clic en `Terminal > Settings` y coloca el tema llamado "Pro" como perfil predeterminado.
44

55
![Pon el tema Pro en la terminal de macOS](images/macos_terminal_pro.png)
66

_partials/fr/dotfiles.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,10 +55,12 @@ cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh
5555

5656
:point_up: On te **demandera** de fournir ton nom (`FirstName LastName`) et ton adresse e-mail.
5757

58-
:warning: Tu **dois** saisir l’une des adresses e-mail indiquées ci-dessus avec la commande `gh api ...` précédente. Sinon, Kitt ne pourra pas suivre tes progrès. 💡 Sélectionnez l'adresse `@users.noreply.github.com` si vous ne souhaitez pas que votre adresse e-mail apparaisse dans les dépôts publics auxquels vous pourriez contribuer.
58+
:warning: Tu **dois** saisir l’une des adresses e-mail indiquées ci-dessus avec la commande `gh api ...` précédente. Sinon, Kitt ne pourra pas suivre tes progrès. 💡 Sélectionne l'adresse `@users.noreply.github.com` si tu ne souhaites pas que ton adresse e-mail apparaisse dans les dépôts publics auxquels tu pourrais contribuer.
5959

6060
**Réinitialise** ton terminal en exécutant :
6161

6262
```bash
6363
exec zsh
6464
```
65+
66+
_Cela recharge ton shell afin qu'il prenne en compte la nouvelle configuration._

_partials/fr/gh_cli.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ Elle doit déjà être installée sur ton ordinateur grâce aux commandes préc
1010

1111
Pour **te connecter**, commence par copier-coller la commande suivante dans ton terminal :
1212

13-
:warning: **NE modifie PAS `email`**
13+
:warning: **NE modifie PAS `email`** — Même si `user:email` ressemble à un emplacement réservé pour ta véritable adresse e-mail, ce n'est pas le cas — ne le remplace pas.
1414

1515
```bash
1616
gh auth login -s 'user:email' -w --git-protocol ssh
@@ -20,9 +20,11 @@ gh auth login -s 'user:email' -w --git-protocol ssh
2020

2121
- `Generate a new SSH key to add to your GitHub account?` Appuie sur `Enter` pour demander à gh de générer les clés SSH pour toi.
2222

23-
Si tu as déjà des clés SSH, tu verras à la place `Upload your SSH public key to your GitHub account?` Avec les flèches, sélectionne le chemain de ta clé publique et appuie sur `Enter`.
23+
Si tu as déjà des clés SSH, tu verras à la place `Upload your SSH public key to your GitHub account?` Avec les flèches, sélectionne le chemin de ta clé publique et appuie sur `Enter`.
2424

25-
- `Enter a passphrase for your new SSH key (Optional)`. Saisis un mot de passe dont tu te souviendras. Ce mot de passe sert à protéger ta clé privée enregistrée sur ton disque sur. Ensuite, appuie sur `Enter`.
25+
- `Enter a passphrase for your new SSH key (Optional)` :
26+
- **POUR LA PLUPART DES GENS :** Appuie simplement sur `Enter` pour passer. Tu n'as pas besoin d'une passphrase pour le bootcamp et cela te serait demandé à chaque utilisation de la clé. Il y a cependant un risque que si quelqu'un vole ton ordinateur, il puisse pousser du code sur GitHub.
27+
- **SI LA SÉCURITÉ EST VRAIMENT IMPORTANTE POUR TOI :** Saisis une passphrase de ton choix et appuie sur `Enter`. Il est _vraiment_ important que si tu saisis une passphrase, tu la notes immédiatement quelque part et ne la perdes/oublies pas. Tu devras la saisir fréquemment.
2628

2729
- `Title for your SSH key`. Tu peux laisser ce qui est proposé par défaut, à savoir "GitHub CLI", appuie sur `Enter`.
2830

_partials/fr/github.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,4 +6,4 @@ Est-ce que tu as déjà un compte GitHub ? Si ce n’est pas le cas, [inscris-t
66

77
![image de GitHub](images/github_picture.png)
88

9-
:point_right: **[Activez l'authentification à deux facteurs (2FA)](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages)**. GitHub vous enverra des messages texte avec un code lorsque vous essayez de vous connecter. C'est important pour la sécurité et cela sera bientôt obligatoire pour contribuer du code sur GitHub.
9+
:point_right: **[Active l'authentification à deux facteurs (2FA)](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages)**. GitHub t'enverra des messages texte avec un code lorsque tu essaies de te connecter. C'est important pour la sécurité et cela sera bientôt obligatoire pour contribuer du code sur GitHub.

0 commit comments

Comments
 (0)