Skip to content

Commit c8d0d7c

Browse files
authored
feat: seperate 'FAQ & Troubleshoot' into 'Install' and 'General' FAQs (#219)
1 parent ad8fb9e commit c8d0d7c

35 files changed

+108
-83
lines changed

docs/contributing/testing/reporting-issues.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -27,8 +27,8 @@ Please report to the [Atlas GitHub Issues](https://github.com/Atlas-OS/Atlas/iss
2727

2828
### If it's from a GitHub branch...
2929

30-
Ideally, report to the `📘 ┃ playbook` channel under our [Discord's 'Development' category](../../faq-and-troubleshooting/common-questions/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.
30+
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.
3131

32-
### If it's a [preview from our Discord](../../faq-and-troubleshooting/common-questions/testing-nightly-builds.md)...
32+
### If it's a [preview from our Discord](../../general-faq/testing-nightly-builds.md)...
3333

3434
Report to the designated `🧪 ┃ issue-reporting` forum channel under the 'Development' category.

docs/contributing/testing/what-to-test.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ icon: material/test-tube
77

88
This page covers what we recommend testing in an in-development build. See [the reporting issues page](reporting-issues.md) if you find any problems.
99

10-
If you haven't set up a virtual machine, see the [Playbook contributing page](../playbook.md) on how to do so. However, feel free to test it on real hardware, especially if it's a [release candidate](../../faq-and-troubleshooting/common-questions/testing-nightly-builds.md)!
10+
If you haven't set up a virtual machine, see the [Playbook contributing page](../playbook.md) on how to do so. However, feel free to test it on real hardware, especially if it's a [release candidate](../../general-faq/testing-nightly-builds.md)!
1111

1212
!!! note "Ensure what you test works on stock Windows first"
1313
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.

docs/faq-and-troubleshooting/common-questions/acrobat-not-installing.md

Lines changed: 0 additions & 19 deletions
This file was deleted.
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
description: Fix error code 1603 when installing Adobe Acrobat
3+
icon: simple/adobeacrobatreader
4+
---
5+
6+
# :simple-adobeacrobatreader: How to fix Adobe Acrobat failing to install?
7+
8+
**If Adobe Acrobat fails to install with error codes such as 1603, you have most likely changed your Atlas settings using the included folder.**
9+
10+
To get Adobe Acrobat to install successfully, you will need to make sure you have enabled [Printing](../getting-started/post-installation/atlas-folder/general-configuration.md#printing). Without the printing service enabled, Adobe Acrobat will continuously fail to install.
11+
12+
## Why is Printing required to install Adobe Acrobat?
13+
14+
During the installation of Adobe Acrobat, the installer will attempt to configure a virtual "Adobe PDF" printer. As this is a virtual printer, it requires the printing service to be enabled for successful installation of printer drivers.
15+
16+
However, after installing Adobe Acrobat, you may choose to disable [Printing](../getting-started/post-installation/atlas-folder/general-configuration.md#printing) if you do not intend to use the included printer driver or any other form of printing.
17+
18+
!!! warning
19+
Disabling [Printing](../getting-started/post-installation/atlas-folder/general-configuration.md#printing) after the installation of Adobe Acrobat is not officially tested or endorsed by Atlas. Therefore, we cannot guarantee stability if you disable [Printing](../getting-started/post-installation/atlas-folder/general-configuration.md#printing) after completing the Adobe Acrobat installation.

docs/faq-and-troubleshooting/common-questions/atlas-and-security.md renamed to docs/general-faq/atlas-and-security.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ We believe that power users should be able to have a choice over the balance bet
1313

1414
Atlas alerts users about the risks of disabling security features, as well as never unknowingly reducing security. One way that this is done is through the AME Wizard configuration prompts.
1515

16-
[Configuring Security in Atlas -->](../../getting-started/post-installation/atlas-folder/security.md)
16+
[Configuring Security in Atlas -->](../getting-started/post-installation/atlas-folder/security.md)
1717

1818
## Security compared to unmodified Windows
1919

@@ -25,7 +25,7 @@ Both Ameliorated and Atlas are always finding ways to be as transparent as possi
2525

2626
## Legacy versions of Atlas
2727

28-
Legacy versions of Atlas, meaning before the `v0.3.x` versions, previously raised many security concerns. We advise anyone that are on these versions of Atlas to [reinstall Windows and upgrade to the latest version](../../getting-started/installation.md).
28+
Legacy versions of Atlas, meaning before the `v0.3.x` versions, previously raised many security concerns. We advise anyone that are on these versions of Atlas to [reinstall Windows and upgrade to the latest version](../getting-started/installation.md).
2929

3030
We listened to the feedback, and we have taken a shift to include maintaining security as a goal of Atlas. Many of the concerns have been rectified in the latest versions, such as:
3131

docs/faq-and-troubleshooting/common-questions/atlas-folder-missing.md renamed to docs/general-faq/atlas-folder-missing.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ icon: material/folder-question
99

1010
If you wish to have the folder on your desktop, you should right-click on the folder and create a shortcut.
1111

12-
![The AtlasDesktop folder on an AtlasOS installation, which is located in the Windows folder](../../assets/images/atlasdesktop-windows-folder.webp)
12+
![The AtlasDesktop folder on an AtlasOS installation, which is located in the Windows folder](../assets/images/atlasdesktop-windows-folder.webp)
1313

1414
## What about if I can't find AtlasDesktop?
1515

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,11 +13,11 @@ Follow these steps to set up Bluetooth:
1313

1414
1. Enable Bluetooth in the Atlas folder.
1515

16-
2. Install your Bluetooth driver. You can get this from your device's OEM or follow our [SDIO guide](../../getting-started/post-installation/drivers/others.md#snappy-driver-installer-origin).
16+
2. Install your Bluetooth driver. You can get this from your device's OEM or follow our [SDIO guide](../getting-started/post-installation/drivers/others.md#snappy-driver-installer-origin).
1717
- Most issues with Bluetooth are caused by installing improper drivers. Make sure to research and find the driver that is suited for your device.
1818

1919
3. Turn on Bluetooth and pair your device.
2020

21-
![The Atlas 'Bluetooth' configuration folder](../../assets/images/bluetooth-script-folder.webp)
21+
![The Atlas 'Bluetooth' configuration folder](../assets/images/bluetooth-script-folder.webp)
2222

2323
If these steps did not resolve your issue, try researching further into the driver you should download for your system. These are almost always the cause and are not an issue directly with AtlasOS.

docs/faq-and-troubleshooting/common-questions/itunes-compatibility.md renamed to docs/general-faq/itunes-compatibility.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,16 +7,16 @@ icon: material/apple
77

88
**If iTunes is not recognizing your Apple device, it's likely a driver issue. You can fix this by downloading and installing the Apple USB Drivers.**
99

10-
If you're using Atlas and have not enabled [Automatic Driver Installation](../../getting-started/post-installation/drivers/getting-started.md#want-driver-installation-updates-through-windows-update-instead), you will need to install the Apple USB driver manually.
10+
If you're using Atlas and have not enabled [Automatic Driver Installation](../getting-started/post-installation/drivers/getting-started.md#want-driver-installation-updates-through-windows-update-instead), you will need to install the Apple USB driver manually.
1111

1212
## :material-package-down: Manual Installation
1313

1414
!!! tip
15-
If you're experiencing significant issues with drivers, consider enabling [Automatic Driver Installation](../../getting-started/post-installation/atlas-folder/general-configuration.md#driver-updates) from the Atlas folder.
15+
If you're experiencing significant issues with drivers, consider enabling [Automatic Driver Installation](../getting-started/post-installation/atlas-folder/general-configuration.md#driver-updates) from the Atlas folder.
1616

1717
1. Download the latest Apple USB drivers from the [Microsoft Update Catalog](https://www.catalog.update.microsoft.com/Search.aspx?q=Apple%2C%20Inc.%20-%20USBDevice) that begins with a three-digit version number.
1818

19-
![You should only select the Apple USB driver that starts with a three-digit version](../../assets/images/apple-driver-version.webp)
19+
![You should only select the Apple USB driver that starts with a three-digit version](../assets/images/apple-driver-version.webp)
2020

2121
2. Extract the downloaded zip file using 7-Zip or Explorer. Ignore any warnings that may appear.
2222

docs/faq-and-troubleshooting/common-questions/microsoft-store.md renamed to docs/general-faq/microsoft-store.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,5 +29,5 @@ If you're experiencing issues with the Microsoft Store, these are unrelated to A
2929
3. Paste in `9WZDNCRFJBMP` and click the tick button
3030
4. Scroll down until you find the files starting with `Microsoft.WindowsStore`
3131
5. Click on the one that has the highest version number and ends in `.msixbundle`
32-
![msstoreappx](../../assets/images/msstoreappx.webp)
32+
![msstoreappx](../assets/images/msstoreappx.webp)
3333
6. Double-click the downloaded file, and click **Install**
Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,6 @@ We often post announcements to the development Discord role when we need help te
1313

1414
These builds are different from the ones automatically built on our GitHub. Official development builds posted on our Discord are ready to be tested for feedback.
1515

16-
See ['Contributing to the Atlas Playbook'](../../contributing/playbook.md) for more information on testing. :smile:
16+
See ['Contributing to the Atlas Playbook'](../contributing/playbook.md) for more information on testing. :smile:
1717

18-
![The Atlas Discord server's 'Channels & Role' page, cropped onto the 'Development' role](../../assets/images/discord-development-role.webp)
18+
![The Atlas Discord server's 'Channels & Role' page, cropped onto the 'Development' role](../assets/images/discord-development-role.webp)

docs/faq-and-troubleshooting/common-questions/updating-atlas.md renamed to docs/general-faq/updating-atlas.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,4 +15,4 @@ Many changes that older Atlas versions made were irreversible, meaning that upda
1515

1616
Previous versions of Atlas [have security concerns](atlas-and-security.md#legacy-versions-of-atlas), which only increase over time due to a lack of Windows Updates. These versions of Atlas are no longer supported, lack features, and lack many bug fixes.
1717

18-
[Reinstalling Windows and installing Atlas -->](../../getting-started/installation.md)
18+
[Reinstalling Windows and installing Atlas -->](../getting-started/installation.md)

docs/faq-and-troubleshooting/common-questions/windows-update-errors.md renamed to docs/general-faq/windows-update-errors.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,13 +9,13 @@ icon: material/update
99

1010
## :material-microsoft-windows: Windows 10 Error 0x80070643
1111

12-
![A screenshot of Windows 10's 'Windows Update' page with the error 0x80070643](../../assets/images/win10-winre-update-error.png)
12+
![A screenshot of Windows 10's 'Windows Update' page with the error 0x80070643](../assets/images/win10-winre-update-error.png)
1313

1414
This issue is on Microsoft's end with the update [KB5034441 for Windows 10](https://support.microsoft.com/en-gb/topic/kb5034441-windows-recovery-environment-update-for-windows-10-version-21h2-and-22h2-january-9-2024-62c04204-aaa5-4fee-a02a-2fdea17075a8). Try the two fixes listed below and retry updates:
1515

1616
1. **Ensure that you have adequate free storage**
1717

18-
You should have at least 1GB of free storage on your Windows drive. If you have little free storage after reinstalling Windows, you likely haven't removed the backup of your previous Windows installation. See [Your old Windows installation](../../getting-started/installation.md#your-old-windows-installation) for more information.
18+
You should have at least 1GB of free storage on your Windows drive. If you have little free storage after reinstalling Windows, you likely haven't removed the backup of your previous Windows installation. See [Your old Windows installation](../getting-started/installation.md#your-old-windows-installation) for more information.
1919

2020
1. **Enable Windows Recovery**
2121
1. Open **Command Prompt as Administrator**

docs/getting-started/installation.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ icon: material/cogs
88

99
This guide will walk you through fully reinstalling Windows, installing Atlas on top of it, and completing other necessary steps. A full Windows reinstall is needed to ensure stability during the initial installation of Atlas.
1010

11-
Before continuing, we recommend reviewing our page on [who Atlas is for](../faq-and-troubleshooting/who-is-atlas-for.md).
11+
Before continuing, we recommend reviewing our page on [who Atlas is for](../install-faq/who-is-atlas-for.md).
1212

1313
<!-- --8<-- [start:prerequisites] -->
1414
## :material-clipboard-list-outline: Prerequisites
@@ -127,15 +127,15 @@ You can find your network driver online by searching for your device/motherboard
127127
1. Type in your noted-down drive letter, including the colon, and then **without a space**, type `\sources\setup.exe` after it. [**Example:** `H:\sources\setup.exe`](../assets/images/win-setup-run-dialog.webp)
128128

129129
1. Press ++enter++ on the Run dialog, and accept the User Account Control prompt
130-
- 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-and-troubleshooting/common-questions/decryptying-using-bitlocker.md) to resolve this, and then attempt this again
130+
- 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](../install-faq/decrypting-using-bitlocker.md) to resolve this, and then attempt this again
131131

132132
1. Select **No thanks** when prompted for updates and uncheck the box for **I want to help make the Windows installation better**
133133

134134
1. Click **I don't have a product key**, as Windows will activate automatically later, presuming that Windows is legitimately activated beforehand
135135

136136
1. Choose your edition of Windows
137137
<!-- --8<-- [end:reinstalling] -->
138-
- 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
138+
- For Atlas, we strongly recommend and officially support Windows Pro, with **Windows Home not being officially supported.** See our page on [Windows Editions](../install-faq/windows-editions.md) for more information
139139
<!-- --8<-- [start:reinstalling1] -->
140140

141141
1. Accept the license agreement and click **Custom: Install Windows only (advanced)**
@@ -198,7 +198,7 @@ You can find your network driver online by searching for your device/motherboard
198198

199199
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**)
200200
<!-- --8<-- [end:reinstalling1] -->
201-
- 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
201+
- For Atlas, we strongly recommend and officially support Windows Pro, with **Windows Home not being officially supported.** See our page on [Windows Editions](../install-faq/windows-editions.md) for more information
202202

203203

204204
### :material-cog: Initial setup (OOBE)
@@ -269,7 +269,7 @@ If you don't know, choose 'Driver Installation & Updates from Windows Update.'
269269
??? danger "AME Wizard suddenly closing or being deleted?"
270270
Add AME Wizard as an exclusion or disable **Real-time protection** in the Windows Security settings. This is usually necessary when a new version of AME Wizard is released, which has not been used much yet.
271271

272-
To read more about this, view our [**AME Wizard Deleted**](../faq-and-troubleshooting/ame-wizard-errors/ame-wizard-deleted.md) page.
272+
To read more about this, view our [**AME Wizard Deleted**](../install-faq/ame-wizard-errors/ame-wizard-deleted.md) page.
273273

274274

275275
1. Open Microsoft Edge, search [`atlasos.net`](https://atlasos.net), then download the **Atlas Playbook** and **AME Wizard**
@@ -279,14 +279,14 @@ If you don't know, choose 'Driver Installation & Updates from Windows Update.'
279279
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
280280

281281
1. Open **Settings** and update Windows, including optional updates, until no more updates are available. If paused, un-pause Windows Updates to follow this step
282-
- If there's an error updating on Windows 10, see our page on [:material-update: Windows Update Errors](../faq-and-troubleshooting/common-questions/windows-update-errors.md#windows-10-error-0x80070643) for a fix, retry updating, and continue with the rest of the installation guide
282+
- 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
283283

284284
1. Open the **Microsoft Store** and update all apps that have pending updates
285285

286286
1. Restart after all updates are complete. After restarting, check again for updates repeatedly until there are no more updates that pop up
287287

288288
1. Open `AME Wizard Beta.exe` from the AME Wizard folder
289-
1. If there is a warning from SmartScreen that AME Wizard is an [unrecognized application](../faq-and-troubleshooting/ame-wizard-errors/ame-wizard-deleted.md#why-is-it-being-falsely-flagged), bypass this warning by clicking **More info** and **Run anyway**
289+
1. If there is a warning from SmartScreen that AME Wizard is an [unrecognized application](../install-faq/ame-wizard-errors/ame-wizard-deleted.md#why-is-it-being-falsely-flagged), bypass this warning by clicking **More info** and **Run anyway**
290290
1. Click on **Updates** at the top and make sure AME Wizard is up to date
291291

292292
1. Drag `Atlas Playbook.apbx` from the Atlas Playbook folder into AME Wizard
@@ -318,6 +318,6 @@ If you need any help, you can find links below to a large community of individua
318318
We hope you enjoy using AtlasOS! :smile:
319319

320320
- [:simple-discord: Discord server](https://discord.atlasos.net) & [:material-forum: Forums](https://forum.atlasos.net)
321-
- [:material-chat-question: FAQ & Troubleshooting](../faq-and-troubleshooting/removed-features.md)
321+
- [:material-chat-question: FAQ & Troubleshooting](../install-faq/removed-features.md)
322322
- [:material-cog: Configure your Atlas installation](post-installation/atlas-folder/general-configuration.md)
323323

0 commit comments

Comments
 (0)