From 57f097d654297d4defdbb8a8351e9f85888b9e5d Mon Sep 17 00:00:00 2001 From: he3als <65787561+he3als@users.noreply.github.com> Date: Sun, 7 Jul 2024 23:04:33 +0100 Subject: [PATCH 01/11] feat: proper revert Atlas page --- .../common-questions/reverting-atlas.md | 12 ----- docs/getting-started/installation.md | 19 ++++++-- docs/getting-started/reverting-atlas.md | 46 +++++++++++++++++++ mkdocs.insiders.yml | 4 ++ mkdocs.yml | 4 +- 5 files changed, 68 insertions(+), 17 deletions(-) delete mode 100644 docs/faq-and-troubleshooting/common-questions/reverting-atlas.md create mode 100644 docs/getting-started/reverting-atlas.md diff --git a/docs/faq-and-troubleshooting/common-questions/reverting-atlas.md b/docs/faq-and-troubleshooting/common-questions/reverting-atlas.md deleted file mode 100644 index 7b12af25..00000000 --- a/docs/faq-and-troubleshooting/common-questions/reverting-atlas.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -description: How do I return to Windows after installing AtlasOS? -icon: material/microsoft-windows ---- - -# :material-microsoft-windows: How do I revert AtlasOS' changes? - -**You'll need to reinstall Windows to revert Atlas' modifications.** - -Due to the number of modifications Atlas makes, there is currently no single-click way to revert its changes. Options built into Windows, such as those from Windows Recovery or Advanced Startup, are not recommended because they will not revert all modifications. - -To reinstall Windows, follow [Microsoft's guide using installation media](https://support.microsoft.com/windows/reinstall-windows-d8369486-3e33-7d9c-dccc-859e2b022fc7) or another guide using an ISO file/installation media. \ No newline at end of file diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md index 63c52733..27e0a8fd 100644 --- a/docs/getting-started/installation.md +++ b/docs/getting-started/installation.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). + ## :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)) + - If you have an ARM-based CPU, you can only use Atlas with Windows 11 - Knowledge of general Windows troubleshooting and usage + ## :material-disc: Download an 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. +To fully reinstall Windows, you need to download your desired Windows version's ISO file, which will be used later in the guide. 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). 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) + + ## :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. + + ## :material-microsoft-windows: Reinstalling Windows !!! question "Which method should I pick?" @@ -124,7 +133,7 @@ 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. 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 1. Accept the license agreement and click **Custom: Install Windows only (advanced)** @@ -185,7 +194,7 @@ 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**) - + ### :material-cog: Initial setup (OOBE) @@ -279,13 +288,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 + ### :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** + ## :material-package-variant-closed-plus: Getting your drivers diff --git a/docs/getting-started/reverting-atlas.md b/docs/getting-started/reverting-atlas.md new file mode 100644 index 00000000..bfb82db6 --- /dev/null +++ b/docs/getting-started/reverting-atlas.md @@ -0,0 +1,46 @@ +--- +title: Reverting Atlas +description: How to revert Atlas and return to stock Windows +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 uninstall Atlas. + +This page details how to reinstall from Atlas to vanilla Windows. + +## :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: + +- The documentation you're on currently +- 'Ask AI' in the corner of this page +- [: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) 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 +--8<-- + +## :material-desktop-classic: Continue with setup + +You should now be at the regular Windows initial setup, back on stock Windows. + +--8<-- "installation.md:oldinstall" \ No newline at end of file diff --git a/mkdocs.insiders.yml b/mkdocs.insiders.yml index e42276a2..3f67059f 100644 --- a/mkdocs.insiders.yml +++ b/mkdocs.insiders.yml @@ -49,5 +49,9 @@ 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' + # https://squidfunk.github.io/mkdocs-material/reference/#built-in-typeset-plugin (Insiders) - typeset diff --git a/mkdocs.yml b/mkdocs.yml index 799a7e16..d443d9c5 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -27,6 +27,8 @@ nav: - Getting Started: - Installation: getting-started/installation.md # discord_friendly_name: ['how-to-install', 'install', 'installation'] + - Reverting Atlas: getting-started/reverting-atlas.md + # discord_friendly_name: ['revert', 'uninstall-atlas'] - Post Installation: - Drivers: - Getting Started: getting-started/post-installation/drivers/getting-started.md @@ -81,7 +83,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 @@ -250,6 +251,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: From dc41ff75b76b29ecc4a75f0efcdedcfbc289d699 Mon Sep 17 00:00:00 2001 From: he3als <65787561+he3als@users.noreply.github.com> Date: Sun, 7 Jul 2024 23:20:44 +0100 Subject: [PATCH 02/11] feat(reverting atlas): clickable AI list item --- docs/getting-started/reverting-atlas.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/getting-started/reverting-atlas.md b/docs/getting-started/reverting-atlas.md index bfb82db6..60774af4 100644 --- a/docs/getting-started/reverting-atlas.md +++ b/docs/getting-started/reverting-atlas.md @@ -14,8 +14,10 @@ This page details how to reinstall from Atlas to vanilla Windows. If you're experiencing issues, ensure you're on the [latest version of Atlas](installation.md), and then consider getting help from the following: -- The documentation you're on currently -- 'Ask AI' in the corner of this page +- :material-file-search: The documentation you're on currently +- +

:material-robot: 'Ask AI' in the corner of this page

+
- [:simple-discord: Our Discord server](https://discord.atlasos.net) - [:material-forum: The Atlas forums](https://forum.atlasos.net) From 779e5390b5549980d2c0052f0f70ff4df5470bd5 Mon Sep 17 00:00:00 2001 From: he3als <65787561+he3als@users.noreply.github.com> Date: Mon, 8 Jul 2024 02:28:18 +0100 Subject: [PATCH 03/11] fix(revert): proper link to github issues --- docs/getting-started/reverting-atlas.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/getting-started/reverting-atlas.md b/docs/getting-started/reverting-atlas.md index 60774af4..9a4f7025 100644 --- a/docs/getting-started/reverting-atlas.md +++ b/docs/getting-started/reverting-atlas.md @@ -25,7 +25,7 @@ If you're experiencing issues, ensure you're on the [latest version of Atlas](in 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) so we can fix it. +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. --- From 297d4795cf350bc14f5bab054f1c7bfe62517fb5 Mon Sep 17 00:00:00 2001 From: he3als <65787561+he3als@users.noreply.github.com> Date: Mon, 8 Jul 2024 02:33:49 +0100 Subject: [PATCH 04/11] fix: make kapa button click a global function --- docs/getting-started/reverting-atlas.md | 2 +- .../{init_kapa_widget.v1.js => init_kapa_widget.v2.js} | 7 ++++++- mkdocs.yml | 2 +- 3 files changed, 8 insertions(+), 3 deletions(-) rename docs/javascript/{init_kapa_widget.v1.js => init_kapa_widget.v2.js} (91%) diff --git a/docs/getting-started/reverting-atlas.md b/docs/getting-started/reverting-atlas.md index 9a4f7025..bc02366f 100644 --- a/docs/getting-started/reverting-atlas.md +++ b/docs/getting-started/reverting-atlas.md @@ -15,7 +15,7 @@ This page details how to reinstall from Atlas to vanilla Windows. 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 -- +-

:material-robot: 'Ask AI' in the corner of this page

- [:simple-discord: Our Discord server](https://discord.atlasos.net) diff --git a/docs/javascript/init_kapa_widget.v1.js b/docs/javascript/init_kapa_widget.v2.js similarity index 91% rename from docs/javascript/init_kapa_widget.v1.js rename to docs/javascript/init_kapa_widget.v2.js index 874c472b..3cb2248f 100644 --- a/docs/javascript/init_kapa_widget.v1.js +++ b/docs/javascript/init_kapa_widget.v2.js @@ -23,4 +23,9 @@ document.addEventListener("DOMContentLoaded", function () { }; document.head.appendChild(script); -}); \ No newline at end of file +}); + +function clickKapaAi() { + const button = document.querySelector('#kapa-widget-container > button') + if (button) button.click() +} diff --git a/mkdocs.yml b/mkdocs.yml index d443d9c5..e43adde0 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -159,7 +159,7 @@ theme: # extra_javascript: - javascript/msdl.v1.js - - javascript/init_kapa_widget.v1.js + - javascript/init_kapa_widget.v2.js extra_css: From f4a6e9e6c9699e88d121e9cb886f19a477cfd95b Mon Sep 17 00:00:00 2001 From: he3als <65787561+he3als@users.noreply.github.com> Date: Mon, 8 Jul 2024 02:35:24 +0100 Subject: [PATCH 05/11] refactor(revert): unnecessary CSS --- docs/getting-started/reverting-atlas.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/getting-started/reverting-atlas.md b/docs/getting-started/reverting-atlas.md index bc02366f..d5198733 100644 --- a/docs/getting-started/reverting-atlas.md +++ b/docs/getting-started/reverting-atlas.md @@ -15,7 +15,7 @@ This page details how to reinstall from Atlas to vanilla Windows. 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 -- +-

:material-robot: 'Ask AI' in the corner of this page

- [:simple-discord: Our Discord server](https://discord.atlasos.net) From e00b58848a3daac96d5a141deb5f49998f8c7bcc Mon Sep 17 00:00:00 2001 From: he3als <65787561+he3als@users.noreply.github.com> Date: Mon, 8 Jul 2024 02:40:55 +0100 Subject: [PATCH 06/11] fix(revert): remove editions step --- docs/getting-started/installation.md | 9 +++++++-- docs/getting-started/reverting-atlas.md | 1 + 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md index 27e0a8fd..7d3e539a 100644 --- a/docs/getting-started/installation.md +++ b/docs/getting-started/installation.md @@ -133,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. 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 + 1. Choose your edition of Windows + + - 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 + 1. Accept the license agreement and click **Custom: Install Windows only (advanced)** @@ -194,7 +197,9 @@ 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**) - + + - 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) diff --git a/docs/getting-started/reverting-atlas.md b/docs/getting-started/reverting-atlas.md index d5198733..9408635e 100644 --- a/docs/getting-started/reverting-atlas.md +++ b/docs/getting-started/reverting-atlas.md @@ -39,6 +39,7 @@ installation.md:iso installation.md:iso1 installation.md:drivers installation.md:reinstalling +installation.md:reinstalling1 --8<-- ## :material-desktop-classic: Continue with setup From b68c25d5041aedeb9c306368893ebde2063a45e2 Mon Sep 17 00:00:00 2001 From: he3als <65787561+he3als@users.noreply.github.com> Date: Mon, 8 Jul 2024 02:43:12 +0100 Subject: [PATCH 07/11] fix(revert): move to FAQ & Troubleshooting anyways --- mkdocs.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/mkdocs.yml b/mkdocs.yml index e43adde0..93eb7ffb 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -27,8 +27,6 @@ nav: - Getting Started: - Installation: getting-started/installation.md # discord_friendly_name: ['how-to-install', 'install', 'installation'] - - Reverting Atlas: getting-started/reverting-atlas.md - # discord_friendly_name: ['revert', 'uninstall-atlas'] - Post Installation: - Drivers: - Getting Started: getting-started/post-installation/drivers/getting-started.md @@ -63,6 +61,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 From 52ccb83f22f7997c3032799ac7d083f8430d2ce3 Mon Sep 17 00:00:00 2001 From: he3als <65787561+he3als@users.noreply.github.com> Date: Mon, 8 Jul 2024 02:45:44 +0100 Subject: [PATCH 08/11] feat(revert): extra redirect --- mkdocs.insiders.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/mkdocs.insiders.yml b/mkdocs.insiders.yml index 3f67059f..571b5e00 100644 --- a/mkdocs.insiders.yml +++ b/mkdocs.insiders.yml @@ -52,6 +52,7 @@ plugins: # 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 From de9d3c1ee340fd11a68e12b13c8c8bf08faf789a Mon Sep 17 00:00:00 2001 From: he3als <65787561+he3als@users.noreply.github.com> Date: Mon, 8 Jul 2024 02:55:07 +0100 Subject: [PATCH 09/11] fix(revert): small grammar --- docs/getting-started/reverting-atlas.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/getting-started/reverting-atlas.md b/docs/getting-started/reverting-atlas.md index 9408635e..142aa90a 100644 --- a/docs/getting-started/reverting-atlas.md +++ b/docs/getting-started/reverting-atlas.md @@ -44,6 +44,6 @@ installation.md:reinstalling1 ## :material-desktop-classic: Continue with setup -You should now be at the regular Windows initial setup, back on stock Windows. +You should now be at the regular Windows initial setup and back on stock Windows. --8<-- "installation.md:oldinstall" \ No newline at end of file From c4065921b5841818a425b2eaa4269174a6639463 Mon Sep 17 00:00:00 2001 From: he3als <65787561+he3als@users.noreply.github.com> Date: Mon, 8 Jul 2024 03:00:21 +0100 Subject: [PATCH 10/11] feat(revert): clarify in intro --- docs/getting-started/reverting-atlas.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/getting-started/reverting-atlas.md b/docs/getting-started/reverting-atlas.md index 142aa90a..e7b55c6d 100644 --- a/docs/getting-started/reverting-atlas.md +++ b/docs/getting-started/reverting-atlas.md @@ -1,14 +1,14 @@ --- title: Reverting Atlas -description: How to revert Atlas and return to stock Windows +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 uninstall 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 vanilla Windows. +This page details how to reinstall from Atlas to stock Windows fully, which uninstalls Atlas. ## :material-handshake: Before uninstalling From d201563692884903ab622f441ccff88e9c71b2c0 Mon Sep 17 00:00:00 2001 From: he3als <65787561+he3als@users.noreply.github.com> Date: Mon, 8 Jul 2024 13:20:43 +0100 Subject: [PATCH 11/11] fix(reverting): formatting issue with Ask AI --- docs/getting-started/reverting-atlas.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/getting-started/reverting-atlas.md b/docs/getting-started/reverting-atlas.md index e7b55c6d..27a97fea 100644 --- a/docs/getting-started/reverting-atlas.md +++ b/docs/getting-started/reverting-atlas.md @@ -16,7 +16,7 @@ If you're experiencing issues, ensure you're on the [latest version of Atlas](in - :material-file-search: The documentation you're on currently - -

:material-robot: 'Ask AI' in the corner of this page

+ :material-robot: 'Ask AI' in the corner of this page
- [:simple-discord: Our Discord server](https://discord.atlasos.net) - [:material-forum: The Atlas forums](https://forum.atlasos.net)