feat: proper Atlas revert page (#217)

Author: he3als

docs/faq-and-troubleshooting/common-questions/reverting-atlas.md

@@ -10,17 +10,22 @@ This guide will walk you through fully reinstalling Windows, installing Atlas on
 
 Before continuing, we recommend reviewing our page on [who Atlas is for](../faq-and-troubleshooting/who-is-atlas-for.md).
 
+<!-- --8<-- [start:prerequisites] -->
 ## :material-clipboard-list-outline: Prerequisites
 
 - Meeting the system requirements for [Windows 11](https://www.microsoft.com/windows/windows-11-specifications#table1) or [Windows 10](https://www.microsoft.com/windows/windows-10-specifications#primaryR2)
     - We don't recommend bypassing Windows 11's requirements due to potential incompatibilities with updates and anticheats
 - 64-bit CPU ([you can check what you have](https://support.microsoft.com/en-us/windows/which-version-of-windows-operating-system-am-i-running-628bec99-476a-2c13-5296-9dd081cdd808))
+    <!-- --8<-- [end:prerequisites] -->
     - If you have an ARM-based CPU, you can only use Atlas with Windows 11
 - Knowledge of general Windows troubleshooting and usage
 
+<!-- --8<-- [start:iso] -->
 ## :material-disc: Download an ISO
+<!-- --8<-- [end:iso] -->
 
-Before installing Atlas, you need to reinstall Windows. To fully reinstall Windows, you need to download your desired Windows version's ISO file, which will be used later in the guide.
+Before installing Atlas, you need to reinstall Windows. <!-- --8<-- [start:iso1] -->
+To fully reinstall Windows, you need to download your desired Windows version's ISO file, which will be used later in the guide.
 
 <span class="noJs">The buttons below download an ISO directly from Microsoft's servers. It gets the latest version of your desired Windows version for [Intel and AMD CPUs](https://www.tenforums.com/tutorials/132836-check-what-processor-cpu-windows-pc.html#option1).</span> ARM ISOs have to be [built manually](https://uupdump.net/fetchupd.php?arch=arm64&ring=retail&build=22631.1).
 
@@ -86,7 +91,9 @@ See the alternatives below.
     styleSheet.innerText = '.noJs { display: revert !important }'
     document.head.appendChild(styleSheet)
 </script>
+<!-- --8<-- [end:iso1] -->
 
+<!-- --8<-- [start:drivers] -->
 ## :material-ethernet: Network Drivers
 
 By default, Windows may not have your computer's network drivers, meaning your computer would be left without a network connection.
@@ -97,7 +104,9 @@ For this reason, we **strongly** recommend that you either:
 - Have the ability to download and transfer network drivers from another device later
 
 You can find your network driver online by searching for your device/motherboard's official support page or your network device's name in [Device Manager](../assets/images/device-manager-nic.webp) instead. If multiple of the latest network drivers are available on your device, download all of them.
+<!-- --8<-- [end:drivers] -->
 
+<!-- --8<-- [start:reinstalling] -->
 ## :material-microsoft-windows: Reinstalling Windows
 
 !!! question "Which method should I pick?"
@@ -124,7 +133,10 @@ You can find your network driver online by searching for your device/motherboard
 
     1. Click **I don't have a product key**, as Windows will activate automatically later, presuming that Windows is legitimately activated beforehand
 
-    1. Choose your edition of Windows. We strongly recommend and officially support Windows Pro, with **Windows Home not being officially supported.** See our page on [Windows Editions](../faq-and-troubleshooting/common-questions/windows-editions.md) for more information
+    1. Choose your edition of Windows
+    <!-- --8<-- [end:reinstalling] -->
+        - For Atlas, we strongly recommend and officially support Windows Pro, with **Windows Home not being officially supported.** See our page on [Windows Editions](../faq-and-troubleshooting/common-questions/windows-editions.md) for more information
+    <!-- --8<-- [start:reinstalling1] -->
 
     1. Accept the license agreement and click **Custom: Install Windows only (advanced)**
 
@@ -185,6 +197,8 @@ You can find your network driver online by searching for your device/motherboard
     1. At the Ventoy menu, select the Windows ISO using the arrow keys, press ++enter++, click **Boot in normal mode**, and press ++enter++ again
 
     1. Follow [Microsoft's guide](https://support.microsoft.com/en-us/windows/reinstall-windows-d8369486-3e33-7d9c-dccc-859e2b022fc7#ID0EDBBBBBBBDBD) for a clean installation from step 4 (clicking **Install now**)
+    <!-- --8<-- [end:reinstalling1] -->
+        - For Atlas, we strongly recommend and officially support Windows Pro, with **Windows Home not being officially supported.** See our page on [Windows Editions](../faq-and-troubleshooting/common-questions/windows-editions.md) for more information
 
 
 ### :material-cog: Initial setup (OOBE)
@@ -279,13 +293,15 @@ If you don't know, choose 'Driver Installation & Updates from Windows Update.'
 
 1. Follow the on-screen instructions from AME Wizard to successfully install AtlasOS
 
+<!-- --8<-- [start:oldinstall] -->
 ### :material-microsoft-windows-classic: Your old Windows installation
 
-If you reinstalled Windows using the method in the documentation, your previous Windows installation should be in `Windows.old`. When you're sure that you've retrieved any valuable data from it, follow these steps:
+If you reinstalled Windows using the no-USB method, your previous Windows installation should be in `Windows.old`. When you're sure that you've retrieved any valuable data from it, follow these steps:
 
 1. Open **Windows Settings** -> **System** -> **Storage**
 1. Click **Temporary files**, and wait for it to scan your files
 1. Select **Previous version of Windows**, and then click **Remove files**
+<!-- --8<-- [end:oldinstall] -->
 
 ## :material-package-variant-closed-plus: Getting your drivers
 

docs/getting-started/installation.md

@@ -0,0 +1,49 @@
+---
+title: Reverting Atlas
+description: How to uninstall AtlasOS
+icon: material/emoticon-cry
+---
+
+# :material-emoticon-cry: Reverting Atlas
+
+As Atlas disables the 'Reset this PC' feature due to its unreliability and not being a true reinstall of Windows, some users get confused about how to get back to stock Windows.
+
+This page details how to reinstall from Atlas to stock Windows fully, which uninstalls Atlas.
+
+## :material-handshake: Before uninstalling
+
+If you're experiencing issues, ensure you're on the [latest version of Atlas](installation.md), and then consider getting help from the following:
+
+- :material-file-search: The documentation you're on currently
+- <a onclick="clickKapaAi();" href="javascript:void(0)">
+    :material-robot: 'Ask AI' in the corner of this page
+  </a>
+- [:simple-discord: Our Discord server](https://discord.atlasos.net)
+- [:material-forum: The Atlas forums](https://forum.atlasos.net)
+
+### If you're still having problems...
+
+We're constantly improving Atlas, so although you're uninstalling now, we hope to see your problem solved in the future.
+
+Please consider reporting your problem on the [Atlas GitHub Issues](https://github.com/Atlas-OS/Atlas/issues) so we can fix it.
+Alternatively, give feedback in our forums or Discord, as mentioned earlier.
+
+---
+
+!!! tip "Looking to reinstall/install Atlas?"
+    Follow the [Atlas installation guide](installation.md) instead. This page is for reverting Atlas.
+
+--8<--
+installation.md:prerequisites
+installation.md:iso
+installation.md:iso1
+installation.md:drivers
+installation.md:reinstalling
+installation.md:reinstalling1
+--8<--
+
+## :material-desktop-classic: Continue with setup
+
+You should now be at the regular Windows initial setup and back on stock Windows.
+
+--8<-- "installation.md:oldinstall"

docs/getting-started/reverting-atlas.md

@@ -23,4 +23,9 @@ document.addEventListener("DOMContentLoaded", function () {
     };
 
     document.head.appendChild(script);
-});
+});
+
+function clickKapaAi() {
+    const button = document.querySelector('#kapa-widget-container > button')
+    if (button) button.click()
+}

docs/javascript/init_kapa_widget.v1.js renamed to docs/javascript/init_kapa_widget.v2.js

@@ -52,5 +52,10 @@ plugins:
           # Moved as it gives mostly software recommendations
         'faq-and-troubleshooting/common-questions/recommended-antiviruses.md': 'getting-started/post-installation/software/anti-virus.md'
 
+          # Moved to a more fully fleged page
+          # Has to be in 'getting-started' for relative links
+        'faq-and-troubleshooting/common-questions/reverting-atlas.md': 'getting-started/reverting-atlas.md'
+        'faq-and-troubleshooting/reverting-atlas.md': 'getting-started/reverting-atlas.md'
+
   # https://squidfunk.github.io/mkdocs-material/reference/#built-in-typeset-plugin (Insiders)
   - typeset

mkdocs.insiders.yml

@@ -60,6 +60,8 @@ nav:
     - What's removed?: faq-and-troubleshooting/removed-features.md
       # discord_bot_names: ['removed-features', 'deleted-features', 'whats-stripped']
     - Who is Atlas for?: faq-and-troubleshooting/who-is-atlas-for.md
+    - Reverting Atlas: getting-started/reverting-atlas.md
+      # discord_friendly_name: ['revert', 'uninstall-atlas']
     - AME Wizard Errors:
       - AME Wizard Deleted: faq-and-troubleshooting/ame-wizard-errors/ame-wizard-deleted.md
       - Atlas Playbook Stuck: faq-and-troubleshooting/ame-wizard-errors/atlas-playbook-stuck.md
@@ -80,7 +82,6 @@ nav:
       - iTunes Compatibility: faq-and-troubleshooting/common-questions/itunes-compatibility.md
       - Installing the Media Pack: faq-and-troubleshooting/common-questions/media-pack-not-found.md
       - Microsoft Store: faq-and-troubleshooting/common-questions/microsoft-store.md
-      - Reverting Atlas: faq-and-troubleshooting/common-questions/reverting-atlas.md
       - Roblox not opening: faq-and-troubleshooting/common-questions/roblox-not-opening.md
       - FIFA/EAFC not launching: faq-and-troubleshooting/common-questions/fifa-and-eafc-not-launching.md
 
@@ -165,7 +166,7 @@ theme:
 #
 extra_javascript:
   - javascript/msdl.v1.js
-  - javascript/init_kapa_widget.v1.js
+  - javascript/init_kapa_widget.v2.js
 
 
 extra_css:
@@ -257,6 +258,7 @@ markdown_extensions:
   - pymdownx.snippets:
       auto_append:
         - includes/abbreviations.md
+      base_path: ['./docs/getting-started/']
 
   # https://squidfunk.github.io/mkdocs-material/reference/content-tabs
   - pymdownx.tabbed: