fix: hyperlinks

pencilnav · pencilnav · commit 843c0e1a2df8 · 2025-10-20T18:36:34.000+08:00
diff --git a/docs/contributing/index.md b/docs/contributing/index.md
@@ -52,7 +52,7 @@ For transparency with users, we keep issues that affect the current release open
 ## :octicons-git-pull-request-24: How to make changes
 
 !!! tip "Unsure if people like your change?"
-	Consider proposing the change to people in the [:simple-discord: Discord](https://discord.gg/atlasos) or [:octicons-issue-opened-16: GitHub issues](https://github.com/Atlas-OS/Atlas/issues) first.
+	Consider proposing the change to people in the [:simple-discord: Discord](https://discord.com/invite/atlasos) or [:octicons-issue-opened-16: GitHub issues](https://github.com/Atlas-OS/Atlas/issues) first.
 	
 	Regardless, remember that it's okay to make mistakes. People will give feedback in your pull requests anyway; don't worry about it too much.
 
diff --git a/docs/contributing/testing/reporting-issues.md b/docs/contributing/testing/reporting-issues.md
@@ -27,8 +27,8 @@ Please report to the [Atlas GitHub Issues](https://github.com/Atlas-OS/Atlas/iss
 
 ### If it's from a GitHub branch...
 
-Ideally, report to the `📘 ┃ playbook` channel under our [Discord's 'Development' category](../../general-faq/testing-nightly-builds.md). Otherwise, report to the [Atlas GitHub Issues](https://github.com/Atlas-OS/Atlas/issues). Ensure that you follow the issue template.
+Ideally, report to the `📘 ┃ playbook` channel under our [Discord's 'Development' category](https://discord.com/invite/atlasos). Otherwise, report to the [Atlas GitHub Issues](https://github.com/Atlas-OS/Atlas/issues). Ensure that you follow the issue template.
 
-### If it's a [preview from our Discord](../../general-faq/testing-nightly-builds.md)...
+### If it's a [preview from our Discord](https://discord.com/invite/atlasos)...
 
 Report to the designated `🧪 ┃ issue-reporting` forum channel under the 'Development' category.
diff --git a/docs/contributing/testing/what-to-test.md b/docs/contributing/testing/what-to-test.md
@@ -7,7 +7,7 @@ icon: material/test-tube
 
 This page covers what we recommend in general alpha or release candidate build testing. If you find any problems, please look at [the reporting issues page](reporting-issues.md).
 
-If you still need to set up a virtual machine, see the [Playbook contributing page](../playbook.md) for instructions. However, feel free to test it on real hardware, especially if it's a [release candidate](../../general-faq/testing-nightly-builds.md)!
+If you still need to set up a virtual machine, see the [Playbook contributing page](../playbook.md) for instructions. However, feel free to test it on real hardware, especially if it's a [release candidate](../../faq/index.md)!
 
 !!! note "Ensure what you test works on stock Windows first"
     To reduce the amount of false reports, please verify that any issues encountered on Atlas do not happen in the same environment and configuration on unmodified Windows.
@@ -47,7 +47,7 @@ As Atlas supports Windows Update, consider testing the following that all make u
 Consider testing local network features such as:
 
 - Windows file sharing
-    - Enable with the [Atlas script](../../getting-started/post-install/atlas-folder/general-configuration.md#file-sharing) first
+    - Enable with the [Atlas script](../../post-install/atlas-folder/configuration.md#file-sharing) first
     - Ensure that it works on stock Windows
 - Screencasting
 - Remote Desktop
diff --git a/docs/faq/post-install.md b/docs/faq/post-install.md
@@ -0,0 +1,6 @@
+---
+description:
+icon: material/download
+---
+
+# :material-list-box: Post Install FAQs
diff --git a/docs/getting-started/install/install-playbook.md b/docs/getting-started/install/install-playbook.md
@@ -7,10 +7,10 @@ icon: material/book-arrow-down
 ## :material-disc: **1.** Download an ISO
 <!-- --8<-- [end:iso] -->
 
-Before installing Atlas, you need a clean ISO.
+Before installing Atlas, you need a clean ISO to fully 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.
+Choose 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, AMD, and ARM CPUs](https://www.tenforums.com/tutorials/132836-check-what-processor-cpu-windows-pc.html#option1).</span>
 
@@ -53,13 +53,23 @@ For this reason, we **strongly** recommend that you do one of the following:
 - Have the ability to download and transfer network drivers from another device later
 
 !!! question "Where do I get my network drivers?"
-    You can find your computer's network drivers online by searching for your device or motherboard's official support page. If you can't find it, try searching online for your network device's name in [Device Manager](../assets/images/device-manager-nic.webp) instead. If multiple of the latest network drivers are available, download them all.
+    !!! info inline ""
+        ![](/assets/images/device-manager-nic.webp)
+
+    You can find your computer's network drivers online by searching for your device or motherboard's official support page. 
+
+    If you can't find it, try searching online for your network device's name in Device Manager instead. 
+    
+    If multiple of the latest network drivers are available, download them all.
+    
+
+    
 <!-- --8<-- [end:drivers] -->
 
 
 ## :material-microsoft-windows: **3.** Reinstalling Windows
 
-Before continuing, we **strongly** recommend you back up any valuable data to an external drive or [a cloud service](https://mega.io/).
+Before continuing, we **strongly** recommend you back up any valuable data to an external drive or [a cloud service](before-continuing.md).
 
 === ":material-microsoft: No USB Drive (recommended)"
 
@@ -73,29 +83,35 @@ Before continuing, we **strongly** recommend you back up any valuable data to an
 
     1. Right-click the previously downloaded ISO file and select **Open With** -> **File Explorer**
 
-    1. Open **This PC** in File Explorer, and remember the ISO's drive letter (e.g. `H`) for the next step. The drive should look similar to ![Windows Setup icon](../assets/images/win-setup.webp){ .twemoji } **CCCOMA_X64FRE_EN-GB_DV9**
+    1. Open **This PC** in File Explorer, and remember the ISO's drive letter (e.g. `H`) for the next step. The drive should look similar to ![Windows Setup icon](/assets/images/win-setup.webp){ .twemoji } **CCCOMA_X64FRE_EN-GB_DV9**
 
     1. Press ++win+r++ to open the Run dialog
 
-    1. Inside the Run dialog, type in the previously remembered drive letter, and then **without a space**, type `:\sources\setup.exe` after it. [**Example:** `H:\sources\setup.exe`](../assets/images/win-setup-run-dialog.webp)
+    1. Inside the Run dialog, type in the previously remembered drive letter, and then **without a space**, type `:\sources\setup.exe` after it. [**Example:** `H:\sources\setup.exe`](/assets/images/win-setup-run-dialog.webp)
 
     1. Press ++enter++ on the Run dialog, and accept the User Account Control prompt
-    - The message ["Make sure BitLocker Drive Encryption is suspended"](../assets/images/bitlocker-error-setup.jpg) could appear from the Windows Setup when you press ++enter++. Refer to our [BitLocker decrypting instructions](../faq/install.md) to resolve this, then retry from step 5 onwards
+    - The message ["Make sure BitLocker Drive Encryption is suspended"](/assets/images/bitlocker-error-setup.jpg) could appear from the Windows Setup when you press ++enter++. Refer to our [BitLocker decrypting instructions](../../faq/install.md) to resolve this, then retry from step 5 onwards
 
     1. Select **No thanks** when prompted for updates, then uncheck the box for **I want to help make the Windows installation better**
 
     1. If prompted, click **I don't have a product key**, as Windows should auto-activate later
         - If Windows doesn't auto-activate, you can enter a key later within Windows
 
-    1. Choose your edition of Windows
+    1. Choose your edition of Windows.
     <!-- --8<-- [end:reinstalling] -->
     <!-- --8<-- [start:atlasEditions] -->
-    - [Windows Pro](../faq/install.md#which-windows-editions-are-supported) is recommended. [Windows Home is not officially supported](../faq/install.md)
-        - If the Windows Setup did not give a choice of edition and it installs Windows Home anyway, you can always change Windows edition later by changing your Windows product key once Windows has finished reinstalling, without having to reinstall anything
+
+    !!! note "Supported Editions"
+
+        - Windows Pro
+        - Windows Pro for Workstation
+        - Windows Enterprise (Excluding LTSC, IoT LTSC)
+
+        **Windows Home is not Supported.** If the Windows Setup did not give a choice of edition and it installs Windows Home anyway, you can always change Windows edition later by changing your Windows product key once Windows has finished reinstalling, without having to reinstall anything.
     <!-- --8<-- [end:atlasEditions] -->
 
     !!! note "Windows 11 Requirement Error?"
-        If installing Windows 11 and you encounter an error stating your PC doesn't meet the requirements, you might need to enable TPM 2.0 in your BIOS/UEFI. See our guide: [:link: Enabling TPM 2.0](../general-faq/enabling-tpm.md)
+        If installing Windows 11 and you encounter an error stating your PC doesn't meet the requirements, you might need to enable TPM 2.0 in your BIOS/UEFI. See our guide: [:link: Enabling TPM 2.0](../../faq/general.md)
 
     <!-- --8<-- [start:reinstalling1] -->
 
@@ -130,7 +146,7 @@ Before continuing, we **strongly** recommend you back up any valuable data to an
                     <p>Credit to [Ventoy](https://ventoy.net/doc_secure.html) for the video demonstration.<p>
                 </center>
             
-            ![vtoy-verification-error-0x1A](../assets/images/vtoy-secure-error.png){ align=right width=200 }
+            ![vtoy-verification-error-0x1A](/assets/images/vtoy-secure-error.png){ align=right width=200 }
 
             If you get an error screen saying there was a 'Security Violation,' follow the steps below:
 
@@ -167,7 +183,7 @@ Before continuing, we **strongly** recommend you back up any valuable data to an
 --8<-- "installation.md:atlasEditions"
 
     !!! note "Windows 11 Requirement Error?"
-        If installing Windows 11 and you encounter an error stating your PC doesn't meet the requirements, you might need to enable TPM 2.0 in your BIOS/UEFI. See our guide: [:link: Enabling TPM 2.0](../general-faq/enabling-tpm.md)
+        If installing Windows 11 and you encounter an error stating your PC doesn't meet the requirements, you might need to enable TPM 2.0 in your BIOS/UEFI. See our guide: [:link: Enabling TPM 2.0](../../faq/general.md)
 
     <!-- --8<-- [start:reinstalling2] -->
 
@@ -259,7 +275,7 @@ If you don't know, choose 'Driver Installation & Updates from Windows Update.'
 ??? danger "AME Wizard suddenly closing or being deleted?"
     Especially when a new version of AME Wizard is released, you might need to add AME Wizard as an exclusion or turn off **Real-time protection** in Windows Security. 
 
-    To read more about this, view our [**AME Wizard Deleted**](../faq/ame.md) page.
+    To read more about this, view our [**AME Wizard Deleted**](../../faq/ame.md) page.
 
 1. Open Microsoft Edge, search [`atlasos.net`](https://atlasos.net)
 
@@ -270,15 +286,15 @@ If you don't know, choose 'Driver Installation & Updates from Windows Update.'
 1. If you have chosen [**Manual Driver Installation**](#driver-updates), run `Disable Drivers Installation in Windows Update.reg` from the extracted Atlas Playbook download and restart
 
 1. Open **Settings** and update Windows, including optional updates, until no more updates are available. If paused, click **Resume Updates** to follow this step
-    - If there's an error updating on Windows 10, see our page on [:material-update: Windows Update Errors](../general-faq/windows-update-errors.md#windows-10-error-0x80070643) for a fix, retry updating, and continue with the rest of the installation guide
+    - If there's an error updating on Windows 10, see our page on [:material-update: Windows Update Errors](../faq/install.md#windows-update-errors) for a fix, retry updating, and continue with the rest of the installation guide
 
 1. Open the **Microsoft Store** and update all apps
     - There might be a prompt to update the Microsoft Store first
 
 1. Restart after all updates are complete. After restarting, check again for updates repeatedly until there are no more available updates
 
 1. Open `AME Wizard Beta.exe` from the AME Wizard folder
-    1. If there is a warning from SmartScreen that AME Wizard is an [unrecognized application](../faq/ame.md#why-is-it-being-falsely-flagged), bypass this warning by clicking **More info** and **Run anyway**
+    1. If there is a warning from SmartScreen that AME Wizard is an [unrecognized application](../faq/ame.md#why-is-ame-being-falsely-flagged), bypass this warning by clicking **More info** and **Run anyway**
     1. Click on **Updates** at the top and make sure AME Wizard is up to date
 
 1. Drag `Atlas Playbook.apbx` from the Atlas Playbook folder into AME Wizard
diff --git a/docs/getting-started/install/setting-up.md b/docs/getting-started/install/setting-up.md
@@ -7,17 +7,17 @@ icon: custom/atlas
 
 You've almost finished setting up Atlas!
 
-- **Manual Driver Installation:** If you previously chose this, we recommend seeing [our post-install driver guide](post-install/drivers/getting-started.md) to help set up the needed drivers.
+- **Manual Driver Installation:** If you previously chose this, we recommend seeing [our post-install driver guide](../../post-install/drivers/index.md) to help set up the needed drivers.
 
-- **Driver Installation & Updates from Windows Update:** If you previously chose this, get drivers by manually checking for Windows Updates. To get them automatically, enable [automatic Windows Updates](../post-install/atlas-folder/general-configuration.md#automatic-updates).
+- **Driver Installation & Updates from Windows Update:** If you previously chose this, get drivers by manually checking for Windows Updates. To get them automatically, enable [automatic Windows Updates](../../post-install/atlas-folder/windows-settings.md).
 
 ## :material-flag-checkered: All done!
 
 If you need any help, you can find links below to a large community of individuals who are dedicated to helping others, as well as a few other areas of the documentation.
 
 We hope you enjoy using AtlasOS! :smile:
 
-- [:material-download: Install your Drivers](post-install/drivers/getting-started.md)
-- [:material-cog: Configure your Atlas installation](post-install/atlas-folder/general-configuration.md)
-- [:simple-discord: Discord server](https://discord.atlasos.net) & [:material-github: GitHub Discussions](https://github.com/Atlas-OS/Atlas/discussions)
-- [:material-chat-question: FAQ & Troubleshooting](../install-faq/removed-features.md)
+- [:material-download: Install your Drivers](../../post-install/drivers/index.md)
+- [:material-cog: Configure your Atlas installation](../../post-install/atlas-folder/index.md)
+- [:simple-discord: Discord server](https://discord.com/invite/atlasos) & [:material-github: GitHub Discussions](https://github.com/Atlas-OS/Atlas/discussions)
+- [:material-chat-question: FAQ & Troubleshooting](../../faq/index.md)
diff --git a/docs/getting-started/upgrade/upgrade-playbook.md b/docs/getting-started/upgrade/upgrade-playbook.md
@@ -23,10 +23,10 @@ icon: material/rocket-launch
 
 ## Troubleshooting & older versions
 
-* If AME Wizard doesn't offer the **Upgrade** option, double-check that you're on Atlas 0.4.x or newer by using the [Checking Atlas Version](../general-faq/checking-atlas-version.md) guide.
-* Systems on **0.3.x** can't be upgraded in-place—follow the [Installation guide](installation.md) for a clean reinstall.
+* If AME Wizard doesn't offer the **Upgrade** option, double-check that you're on Atlas 0.4.x or newer by using the [Checking Atlas Version](../../faq/general.md#checking-atlas-version) guide.
+* Systems on **0.3.x** can't be upgraded in-place—follow the [Installation guide](../install/before-continuing.md) for a clean reinstall.
 
 ---
 
-Need help? Ask in the [:simple-discord: Discord server](https://discord.atlasos.net) or open a topic on [:material-github: GitHub Discussions](https://github.com/Atlas-OS/Atlas/discussions). 
+Need help? Ask in the [:simple-discord: Discord server](https://discord.com/invite/atlasos) or open a topic on [:material-github: GitHub Discussions](https://github.com/Atlas-OS/Atlas/discussions). 
 
diff --git a/docs/index.md b/docs/index.md
@@ -33,13 +33,13 @@ icon: material/home
 
     [-> FAQ](faq/index.md)
 
--   :material-handshake:{ .lg .middle } __Development__
+-   :material-handshake:{ .lg .middle } __Contributing & Development__
 
     ---
 
     Learn how you can contribute to AtlasOS, and do so effectively.
 
-    [-> Contribution Guidelines](contributing/index.md)
+    [-> Contribution](contributing/index.md)
 
 </div>
 
@@ -51,5 +51,5 @@ If you'd like to learn more, see our:
 
 - [:simple-github: GitHub repository README](https://github.com/Atlas-OS/Atlas) for more in-depth overviews
 - [:simple-github: GitHub repository's source code](https://github.com/Atlas-OS/Atlas/tree/main/src) for what Atlas does under the hood
-- [:simple-discord: Discord server](https://discord.atlasos.net/) to connect with the Atlas community and get support
+- [:simple-discord: Discord server](https://discord.com/invite/atlasos) to connect with the Atlas community and get support
 - [:custom-atlas: Website](https://atlasos.net/) for a general overview of Atlas
diff --git a/docs/post-install/atlas-folder/security.md b/docs/post-install/atlas-folder/security.md
@@ -14,7 +14,7 @@ icon: material/security
     **Atlas is not responsible** for any damages caused by disabling security features against our recommendations.
 
 !!! tip
-    If you deleted the folder, check out [our guide to restore the Atlas folder](../../../faq-and-troubleshooting/common-questions/atlas-folder-missing.md)..
+    If you deleted the folder, check out [our guide to restore the Atlas folder](../../faq/post-install.md)..
 
 In this section, we will list all of the 'Security' options in the Atlas folder, how to change them and their defaults.
 
diff --git a/docs/post-install/hardware/index.md b/docs/post-install/hardware/index.md
@@ -1 +1,17 @@
-## TBD
+---
+title: Hardware
+description: Hardware-related post-install guidance for AtlasOS — enabling XMP/DOCP, Resizable BAR, and BIOS/UEFI updates.
+---
+
+# :material-memory: Getting Started with Hardware
+
+This section contains hardware-focused post-installation guidance to help you get the most out of your system after installing AtlasOS. Topics include memory overclocking (XMP/DOCP), Resizable BAR, and safely updating your BIOS/UEFI.
+
+Quick links:
+
+- [:material-flash:auto: Enabling XMP/DOCP](enabling-xmp-or-docp.md) — How to enable and validate XMP or DOCP safely.
+- [:material-chip: Resizable BAR](resizable-bar.md) — What Resizable BAR is and how to enable it for supported systems.
+- [:material-system-update: Updating BIOS/UEFI](updating-the-bios.md) — Best practices for updating firmware safely.
+
+If you're unsure where to start, follow the order above: enable XMP/DOCP if you need memory speed, then check Resizable BAR if you have a supported GPU/motherboard, and update BIOS only when necessary and after backing up important data.
+
diff --git a/docs/post-install/hardware/resizable-bar.md b/docs/post-install/hardware/resizable-bar.md
@@ -26,7 +26,7 @@ If you do not meet these specifications, it's recommended to not enable the feat
 ## :material-progress-question: How to Check if Resizable BAR is Enabled?
 
 1. [Download GPU-Z](https://www.techpowerup.com/download/techpowerup-gpu-z/) and open the application
-1. Check to see if **Rezisable BAR** is disabled or enabled [**GPU-Z Example**](../../../assets/images/gpu-z-resizable-bar.png).
+1. Check to see if **Rezisable BAR** is disabled or enabled [**GPU-Z Example**](../../assets/images/gpu-z-resizable-bar.png).
     1. GPU-Z allows you to see why it's disabled. Click on **Disabled** to see more information about what you're missing.
 
 ## :material-check: How to Enable Resizable BAR?
diff --git a/docs/post-install/index.md b/docs/post-install/index.md
@@ -13,7 +13,7 @@ Use the links below to jump to the topic you need:
 - [:material-chip: Drivers](drivers/index.md) — Guidance for installing and updating device drivers (Intel, AMD, NVIDIA, chipsets, and others).
 - [:material-memory: Hardware](hardware/index.md) — Hardware-related optimizations such as enabling XMP/DOCP, Resizable BAR, and BIOS/UEFI updates.
 - [:material-microsoft-windows: Software](software/index.md) — Suggested apps and software settings including anti-virus, media playback, image viewers, and more.
-- [:custom-atlas:]
+- [:custom-atlas: Atlas Folder](atlas-folder/index.md) — The Atlas Folder.
 
 If you’re unsure where to start, follow the order above:.
 
diff --git a/mkdocs.yml b/mkdocs.yml
diff --git a/overrides/404.html b/overrides/404.html
