diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs
index 4dc14cb..9634f8b 100644
--- a/docs/astro.config.mjs
+++ b/docs/astro.config.mjs
@@ -10,7 +10,7 @@ export default defineConfig({
src: './public/angular-challenge.webp',
alt: 'angular challenges logo',
},
- favicon: './public/angular-challenge.ico',
+ favicon: './angular-challenge.ico',
social: {
github: 'https://github.com/withastro/starlight',
linkedin: 'https://www.linkedin.com/in/thomas-laforge-2b05a945/',
diff --git a/docs/src/assets/new-pull-request.png b/docs/src/assets/new-pull-request.png
new file mode 100644
index 0000000..085accc
Binary files /dev/null and b/docs/src/assets/new-pull-request.png differ
diff --git a/docs/src/content/docs/guides/getting-started.md b/docs/src/content/docs/guides/getting-started.md
index d6245af..9609c8d 100644
--- a/docs/src/content/docs/guides/getting-started.md
+++ b/docs/src/content/docs/guides/getting-started.md
@@ -22,7 +22,7 @@ git clone https://github.com/[YOUR_GITHUB_NAME]/angular-challenges.git
```
:::note
-Your can find the url to clone on the button labeled <> Code on your **OWN INSTANCE** of the Angular Challenge repository.
+Your can find the url to clone on the button labeled <> Code on your **OWN INSTANCE** of the Angular Challenge repository.

diff --git a/docs/src/content/docs/guides/resolve-challenge.md b/docs/src/content/docs/guides/resolve-challenge.md
index 712de6e..57077ad 100644
--- a/docs/src/content/docs/guides/resolve-challenge.md
+++ b/docs/src/content/docs/guides/resolve-challenge.md
@@ -30,8 +30,60 @@ npm i -g nx
## Create a git branch
-Before starting implementing your own solution to resolve a challenge, create a git branch to save your work.
+Before starting implementing your own solution to resolve a challenge, create a git branch to commit your work.
```bash
git checkout -b
```
+
+## Resolve the challenge
+
+Resolve the challenge following the instruction
+
+## Commit and Push your work
+
+Last step is to commit your work following the [Conventional Guidelines](https://www.conventionalcommits.org/en/v1.0.0/).
+
+Finaly, push your work to the remote reposository with the following command
+
+```bash
+ git push --set-upstream origin
+```
+
+:::tip[Don't remember it]
+You don't have to remember the command precisely. You just need to remember `git push` and if it's the first time you are pushing this branch, `git` will give you the complete command.
+:::
+
+## Submit your work to the main repository
+
+Now, all your work is located insite your local instance of the Angular Challenge repository.
+
+Next step is to go to the main [Angular Challenge page](https://github.com/tomalaforge/angular-challenges) and create a new Pull Request.
+
+Github should pop a notification header to help you create that pull request.
+
+If it's not the case, you either have done one of the previous step wrong or you can go to the **Pull Request** tab and click the button New pull request.
+
+Once you have choosen the two branches to compare, you should arrive on the following page:
+
+
+
+Inside the title section, you should start with **Answer:** following by your **challenge number**, after that you are free to add anything you would like.
+
+:::danger
+This is very important. It lets other know what challenge you are trying to resolve
+:::
+
+Inside the description section, you can add questions, troubles you add or anything you want to share. You can leave it empty if you don't have anything to say.
+
+You can now click on Create pull request.
+
+I will read and comment on it when I have some free time.
+
+:::note
+Anybody is welcomed to comment and read other PR.
+:::
+
+:::tip[OSS champion]
+🔥 Once you have completed this tutorial once, you are ready to go inside any other public github repository and submit a PR. It is as easy as that. 🔥
+:::
diff --git a/docs/src/styles/custom-css.css b/docs/src/styles/custom-css.css
index 28a114a..7bba028 100644
--- a/docs/src/styles/custom-css.css
+++ b/docs/src/styles/custom-css.css
@@ -10,7 +10,7 @@
/* --sl-font: 'IBM Plex Serif', serif; */
}
-.code-btn {
+.github-success-btn {
border: 2px solid rgba(240, 246, 252, 0.1);
border-radius: 6px;
padding: 2px 8px;