From ebedacafa3953efe887b646dd8559de8daf63b99 Mon Sep 17 00:00:00 2001
From: rad <80015713+RadNotRed@users.noreply.github.com>
Date: Sat, 7 Dec 2024 19:35:36 -0500
Subject: [PATCH] docs: update installation instructions for ISO downloads and
 add placeholders for MSDL

---
 docs/getting-started/installation.md    | 28 ++++++++++++++++++++++---
 docs/getting-started/reverting-atlas.md |  2 +-
 2 files changed, 26 insertions(+), 4 deletions(-)

diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md
index 579865f8..e9a53558 100644
--- a/docs/getting-started/installation.md
+++ b/docs/getting-started/installation.md
@@ -47,9 +47,31 @@ See the alternatives below.
     If you meet the official requirements, we **strongly** recommend choosing Windows 11. If not, use Windows 10.
 
 !!! failure "MSDL is currently not working"
-    Please use the alternative method mentioned below to download your ISOs.
+    Please download the ISO from [official microsoft sources.](#official-microsoft-sources)
 
+<!-- Remember to revert this back to ??? from !!! when MSDL is fixed. -->
+<!-- Please don't remove the "Offical Microsoft Sources" tab when MSDL is fixed either. -->
 !!! grey-tip "Alternatives"
+
+    !!! tip 
+        Even though the downloader we use in our docs use Microsoft's servers, you can also download the ISO directly from Microsoft or use the Windows Media Creation Tool.
+
+    <div id="official-microsoft-sources"></div>
+    === "Official Microsoft Sources"
+
+        ### [Windows 11 :material-download:](https://www.microsoft.com/en-us/software-download/windows11)
+
+        - Click the link above and **scroll down** to **Download Windows 11 Disk Image (ISO) for x64 devices.**<br> **DO NOT** use the **Installation Assistant** or **Create Windows 11 Installation Media.**
+        - Select **Windows 11 (multi-edition ISO for x64 devices)** and click **Download Now.**
+        - Select your desired language and press confirm.
+        - Click **64-bit Download** to begin your download.
+
+        ### [Windows 10 :material-download:](https://www.microsoft.com/en-us/software-download/windows10ISO)
+
+        - Click the link abvove and select **Windows 10 (multi-edition ISO)** and click **Confirm.**
+        - Select your desired language and press confirm.
+        - Click **64-bit Download** to begin your download.
+
     === "Windows Media Creation Tool"
 
         1. Download the [Windows 10 :material-download:](https://go.microsoft.com/fwlink/?LinkId=691209) or [Windows 11 :material-download:](https://go.microsoft.com/fwlink/?linkid=2156295) Media Creation Tool, then open it
@@ -61,8 +83,8 @@ See the alternatives below.
         1. Choose the **ISO file** option, then choose the download location
         1. After the ISO has completed downloading, click **Finish**
 
- <!-- --8<-- [end:iso1] -->
-
+<!-- --8<-- [end:iso1] -->
+<!-- Placeholder for msdl.md include -->
 
 
 <!-- --8<-- [start:drivers] -->
diff --git a/docs/getting-started/reverting-atlas.md b/docs/getting-started/reverting-atlas.md
index 1c863a1d..c101757b 100644
--- a/docs/getting-started/reverting-atlas.md
+++ b/docs/getting-started/reverting-atlas.md
@@ -38,7 +38,7 @@ installation.md:style
 installation.md:iso
 installation.md:iso1
 --8<--
-
+<!-- Placeholder for msdl.md include -->
 --8<--
 installation.md:drivers
 installation.md:reinstalling