public/subjects/introduction.en.md

## Introduction

### Instructions

#### 1- get-ready

Create in your `git account` the repository named `piscine-go`.

This repository will be the folder where all the exercices must be uploaded.

Once created, clone that repository on your desktop.
If your `username` was `kigiri` this is the command that will need to be used :

`git clone https://01.alem.school/kigiri/piscine-go.git`

This command needs to be adapted with **your own username**.

If the `git clone` gives you an authenticity of host error, your SSH key nmust be configured. 
Follow the steps below. 

#### SSH Configuration 

**With the USB key plugged in!!**

Execute the following commands:

```console
mkdir -p ~/.ssh
ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519 -N ''
cat ~/.ssh/id_ed25519.pub
```
-Copy the result and paste it in the content field of adding an ssh key in your settings (adapt the link with your username).
https://git.01.alem.school/{username}/settings/keys

-Confirm by clicking on the add key button. 

Once this is done the git clone command should work now. 

#### 2- set

Once the repository is created, write your first shell program called `hello.sh`

When executed this program must print `Hello {username}!`
Where `{username}` is your `username`

##### Usage

If the `{username}` is `kigiri` :

```console
user@host:~/piscine-go$ ./hello.sh
Hello kigiri!
user@host:~/piscine-go$
```

#### 3- go-say-hello

After that the `hello.sh` is executing correctly, it needs to be uploaded to the repository with the following commands :

1. `git add hello.sh`
2. `git commit -m "My very first commit"`
3. `git push origin master`

Once these steps are applied, the file can now be submitted for grading on the platform by clicking on the `submit` button.

This action will run the tests on your submitted `hello.sh` file.