Add informations for gibMacRecovery

_usbpreparations/05-recoveryOS/01-gibMacRecovery/index.md

@@ -38,14 +38,45 @@ has_toc: false
 
 <h2 align="center">Placeholder Information</h2>
 
-<h2 align="center">
-  <br>
-  <div class="windows-next-button-container">
-  <a class="windows-next-button" href="../01-Windows/">Windows &rarr;</a>
-  </div>
-  <div class="navigation-container">
-    <a class="nav-button" href="../../../05-recoveryOS/index/">&larr; Back Page</a>
-    <a class="nav-button" href="../02-Linux/">Linux &rarr;</a>
-  </div>
-  <br>
-</h2>
+## Downloading recoveryOS
+
+Next, we want to download the macOS recovery environment. For this we use a tool from CorpNewt: [gibMacRecovery](https://github.com/corpnewt/gibMacRecovery). Just as all other tools: This is a Python script, so we have to get it first, either by downloading the main branch or cloning the repository as is.
+Just like before, we have different scripts to choose from for different platforms. Again, choose the right one for your OS.
+
+<p align="center">
+  <img width="1275" height="1236" src="/assets/gibMacRecovery/gibmacRecoveryRepo.png">
+</p>
+
+Once we have started gibMacRecovery, we should see the following menu:
+
+<p align="center">
+  <img width="698" height="417" src="/assets/gibMacRecovery/gibmacRecoveryStart.png">
+</p>
+
+First, we want to choose option 1) to download the recovery catalog.
+Afterwards, we want to choose option 2). Here we can select a macOS version to choose from.
+
+<p align="center">
+  <img width="697" height="459" src="/assets/gibMacRecovery/gibmacRecoveryCatalog.png">
+</p>
+
+{: .warning }
+Its not possible to install OS X 10.4 Tiger to OS X 10.6 Snow Leopard using gibMacRecovery.
+
+We now select the recovery environment for the operating system we want to install. After that, we return to the menu and finally select option 7) to download the recovery.
+
+<p align="center">
+  <img width="697" height="459" src="/assets/gibMacRecovery/gibmacRecoveryDownloading.png">
+</p>
+
+Once we finished downloading, we can close the program. We should now find a new folder in our Mac Recovery directory. Depending on the target version, the folder contains a large file called ``BaseSystem.dmg`` or ``RecoveryImage.dmg`` and a small associated chunklist.
+
+<p align="center">
+  <img width="528" height="340" src="/assets/gibMacRecovery/gibmacRecoveryResults.png">
+</p>
+
+We want to place the folder with the containing files in the root directory of our installation media, just next to our ``EFI`` folder. If everything worked, we can continue.
+
+<p align="center">
+  <img width="428" height="340" src="/assets/gibMacRecovery/gibmacRecoveryPlaced.png">
+</p>

docs/03-Changelog/index.md

@@ -37,6 +37,33 @@ All notable changes to this project will be documented in this file. The format
 
 ---
 
+## Added visual explanations for downloading recovery using gibMacRecovery
+### Prerelease@CarnationsInternal
+#### By Tammo
+
+## [Version~Type] - 2024-09-16
+
+### Added
+- Added informations about gibMacRecovery and its usage - general information about the recovery enviroment is still needed.
+
+### Changed
+-
+
+### Fixed
+-
+
+### Deprecated
+-
+
+### Removed
+- Windows and Linux section - there's no point in having both since gibMacRecovery is a cross-platform script
+- Buttons - they will have to be added again.
+
+### Security
+-
+
+---
+
 ## Added visual explanations for downloading and Using ProperTree
 ### Prerelease@CarnationsInternal
 #### By Tammo