Dev to main

.github/CONTRIBUTING.md

@@ -18,8 +18,8 @@ We use the [Insiders edition of Material for MkDocs](https://squidfunk.github.io
 
 ## Issues
 
-If you find any issues with our documentation, please open an issue [here](https://github.com/Atlas-OS/docs/issues/new). Please fill issues out with utmost detail and preferably images too so we can understand where we went wrong or so contributors can make a pull request to fix the issue.
+If you find any issues with our documentation, please [open an issue](https://github.com/Atlas-OS/docs/issues/new). Please fill issues out with utmost detail and preferably images too so we can understand where we went wrong or so contributors can make a pull request to fix the issue.
 
 ## More help?
 
-You can follow the [GitHub docs contributing guide](https://github.com/github/docs/blob/main/CONTRIBUTING.md) for more help. You can also ask in our [Discord server](https://discord.atlasos.net) for more help as well.
+You can follow the [GitHub docs contributing guide](https://github.com/github/docs/blob/main/CONTRIBUTING.md) for more help. You can also ask in our [Discord server](https://discord.atlasos.net) for more help as well.

.gitignore

@@ -1,24 +1,30 @@
 # Directories
 .cache/
 site/
+.jampack/
+
+# Dependencies
+node_modules/
+
+# Logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
 
 # MacOS related
 .DS_Store
 .AppleDouble
 .LSOverride
-
 Icon
-
 ._*
-
 .DocumentRevisions-V100
 .fseventsd
 .Spotlight-V100
 .TemporaryItems
 .Trashes
 .VolumeIcon.icns
 .com.apple.timemachine.donotpresent
-
 .AppleDB
 .AppleDesktop
 Network Trash Folder

README.md

@@ -10,6 +10,6 @@ Here you can help Atlas with documentation, for now we do not have translation c
 
 As MkDocs uses Python, you will need to have Python and pip installed, we recommend using [Scoop](https://scoop.sh) or [Chocolatey](https://chocolatey.org) to install these but you can also install via [Python's website](https://www.python.org).
 
-Material for MkDocs has already made a page, which you can use for Installation of Material for MkDocs [here](https://squidfunk.github.io/mkdocs-material/getting-started).
+Material for MkDocs has already made a page, which you can use for [Installation of Material for MkDocs](https://squidfunk.github.io/mkdocs-material/getting-started).
 
-Depending if you installed it locally or via a virtual envioronment, there is already a guide on previewing [here](https://squidfunk.github.io/mkdocs-material/creating-your-site/#previewing-as-you-write)
+Depending if you installed it locally or via a virtual envioronment, there is already a [guide on previewing](https://squidfunk.github.io/mkdocs-material/creating-your-site/#previewing-as-you-write)

docs/contributions.md

@@ -24,7 +24,7 @@ Alternatively, you can use the [Git](https://git-scm.com/) command-line. Use whi
 	* Read [this](https://github.com/Atlas-OS/docs/blob/master/.github/CONTRIBUTING.md) documentation-specific contribution guide as well as these contribution guidelines to setup a development environment
 	* Reading the [GitHub documentation contribution guide](https://github.com/github/docs/blob/main/CONTRIBUTING.md) might also be useful
 
-These are the main three repositories to contribute to. There might also be other repositories that you can contribute to, see [here](https://github.com/Atlas-OS).
+These are the main three repositories to contribute to. There might also may be other repositories that fits your expertise. [Check out our GitHub organisation](https://github.com/Atlas-OS).
 
 If a repository has a specified template for pull requests or issues, please use them. Otherwise, your pull request could be closed.
 
@@ -33,11 +33,11 @@ If a repository has a specified template for pull requests or issues, please use
 There is a `dev` branch and a `main` or `master` branch for development on each repository.
 
 !!! warning
-	Make **all of your changes** to the `dev` branch of the respective repositories! 
+	Make **all of your changes** to the `dev` branch of the respective repositories!
 
 	Never commit or pull request directly to the `main` branches, with the **only exception** being committing to the `main` branch on the main repository for translations.
 
-The reason why the `dev` branch exists is to ensure that the `main` branch only has approved and high quality changes. 
+The reason why the `dev` branch exists is to ensure that the `main` branch only has approved and high quality changes.
 
 A pull request **every week** will be automatically created to merge the `dev` branch into the `main` branch, where the changes can be properly reviewed by **5 contributors** before the pull request is merged. The only exclusion to having less than 5 reviews is if there's not enough people reviewing, e.g. 4 reviews for documentation.
 
@@ -49,12 +49,12 @@ You will have to make your own fork of the respective Atlas repository, and then
 
 !!! note
 	This only applies to people with direct access to commit to the repositories, without the need to do a pull request.
-
-	The list of people that have access is [here](https://github.com/orgs/Atlas-OS/people).
 
-If there's any big changes, you should instead make a pull request for `dev` instead of directly committing to it. Some examples of big changes could be mass formatting changes, feature changes, or anything similar. 
+	This list is from [our GitHub organisation's member list](https://github.com/orgs/Atlas-OS/people).
 
-This means less potential headache in the future if the change is disagreed upon, as you can avoid reverting all of the disliked changes for the automatic pull request every week. 
+If there's any big changes, you should instead make a pull request for `dev` instead of directly committing to it. Some examples of big changes could be mass formatting changes, feature changes, or anything similar.
+
+This means less potential headache in the future if the change is disagreed upon, as you can avoid reverting all of the disliked changes for the automatic pull request every week.
 
 If you want to, you can also manually trigger the automatic pull request to merge `dev` into `main` early, but the 5 reviews will still be in effect. As a note, if you need to urgently fix something, you can use the `bypass` label to bypass your pull request being automatically closed by the pull request filter.
 
@@ -75,11 +75,11 @@ Making sure that your commits are already to a high standard means that developm
 ### :octicons-verified-16: Commit Signature Verification
 It is also highly recommended to setup [commit signature verification](https://docs.github.com/en/authentication/managing-commit-signature-verification), which means that your commits will be marked as 'Verified' so that other people will know that your commits come from a trusted source.
 
-You can install [GPG](https://gnupg.org/) (used for signing) on Windows with [Scoop](https://scoop.sh/) with the following command:
+You can install [GPG](https://gnupg.org/) (used for signing) in Windows with [Scoop](https://scoop.sh/) with the following command:
 ```
 scoop install gpg
 ```
-For a more simple guide, click [here](https://gist.github.com/Beneboe/3183a8a9eb53439dbee07c90b344c77e#file-how-to-setup-verified-commits-md).
+Check out this for a detailed [guide on setting up verified commits](https://gist.github.com/Beneboe/3183a8a9eb53439dbee07c90b344c77e#file-how-to-setup-verified-commits-md).
 
 ### :octicons-git-branch-16: Conventional Commits
 
@@ -88,4 +88,4 @@ Preferably use [Conventional Commits](https://www.conventionalcommits.org/) for
 *Example*: [`feat: ✨ add fAllowFullControl`](https://github.com/Atlas-OS/Atlas/commit/72cdcc7b327df19fd07e9c6eb0a10812ac6936b0)
 
 - [**Extension for Visual Studio Code**](https://github.com/vivaxy/vscode-conventional-commits)
-- [**Emoji reference**](https://gitmoji.dev) (optional)
+- [**Emoji reference**](https://gitmoji.dev) (optional)

docs/faq-and-troubleshooting/atlas-and-security.md

@@ -0,0 +1,10 @@
+---
+description: How secure is AtlasOS?
+icon: material/shield
+---
+
+# How secure is Atlas?
+
+**Atlas is as secure as you want it to be, with the ability to enable or disable Defender, enable or disable Core isolation and Windows Update compatibility.**
+
+Atlas also does extra improvements to security within Windows by disabling various obselete and potentially vulnerable features.

docs/faq-and-troubleshooting/common-questions/adobe-acrobat.md

@@ -0,0 +1,14 @@
+---
+description: How to fix Adobe Acrobat fails to install on AtlasOS
+icon: simple/adobe
+---
+
+# How to fix Adobe Acrobat not installing?
+
+**Printing must be enabled (via the Atlas folder) to install Adobe Acrobat correctly**
+
+This can be found in the Atlas folder, under configuration.
+
+This is because Adobe installs the "Adobe PDF" printer on your system. Adobe PDF is a printer driver that saves documents in a format called Adobe PDF.
+
+<image src="/assets/images/printer-script-folder.png" style="border-radius:8px" />

docs/faq-and-troubleshooting/common-questions/ame-wizard-virus-detection.md

@@ -0,0 +1,12 @@
+---
+description: Why is AME Wizard being detected as a virus?
+icon: material/virus
+---
+
+# Why is AME Wizard being detected as a virus?
+
+**AME Wizard can be falsely flagged as a virus when a new version is published. To avoid it being detected, add it to your Windows Defender exclusions list.**
+
+Windows Security may automatically flag AME Wizard as malicious when trying to run it, or may even delete it before running it.
+
+To avoid these problems you can temporarily disable **Real Time Protection** or follow [AME's Security Exceptions Documentation (recommended)](https://docs.ameliorated.io/guides/security-exceptions.html).

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

@@ -0,0 +1,12 @@
+---
+description: How to fix missing Atlas folder on AtlasOS
+icon: material/folder-question
+---
+
+# How to fix Atlas folder missing?
+
+**If there is not a shortcut for the folder on your desktop, you can find it here: `C:/Windows/AtlasDesktop`.**
+
+If you wish to have the folder on your desktop, instead of moving the main folder we recommend you create a shortcut and place it on your desktop.
+
+<img src=/assets/images/atlasdesktop-windows-folder.png style="border-radius:8px" />

docs/faq-and-troubleshooting/common-questions/atlas-iso-files.md

@@ -0,0 +1,14 @@
+---
+description: Where can I find the Atlas ISO file?
+icon: material/disc
+---
+
+# Where is the Atlas ISO file?
+
+**Atlas doesn't have an ISO file. It uses AME Wizard to modify Windows on a new live installation, applying configurations like an ISO file.**
+
+Distributing ISO files violates Microsoft's EULA and poses safety risks due to uncertainty about the contents. We use AME Wizard and use releases directly from our GitHub. We also include a checksum in case you wish to verify the integrity of your download.
+
+> "For software downloads, unless expressly permitted in the accompanying License Terms or End-User License Agreement (EULA), Microsoft does not allow redistribution. You may link to the download page, but not directly to the download, from your product or website."
+
+🔗 [https://www.microsoft.com/en-us/legal/intellectualproperty/copyright/permissions](https://www.microsoft.com/en-us/legal/intellectualproperty/copyright/permissions)

docs/faq-and-troubleshooting/common-questions/bluetooth-compatibility.md

@@ -0,0 +1,23 @@
+---
+description: Does Bluetooth work on AtlasOS?
+icon: material/bluetooth
+---
+
+# Does Bluetooth work on AtlasOS?
+
+**Yes, Bluetooth is fully functional on Atlas, you can choose to enable or disable it during installation.**
+
+If you're using Atlas and not using Automatic Driver Installation, you will need to install the Bluetooth driver yourself.
+
+These steps will guide you on getting setup with Bluetooth:
+
+1. Enable Bluetooth in the Atlas folder
+
+2. Install your Bluetooth driver (from OEM or via our [SDIO guide](../../getting-started/post-installation/drivers/getting-started.md#snappy-driver-installer-origin))
+    - Most issues with Bluetooth are caused by installing improper drivers. Make sure you research and find the driver which is suited for your device.
+
+3. Turn ON Bluetooth, and pair your device
+
+<img src="/assets/images/bluetooth-script-folder.png" style="border-radius:8px" />
+
+If this did not work, try researching further into the driver you should download for your system. These are almost always the cause and is not an issue directly with Atlas.

docs/faq-and-troubleshooting/common-questions/decryptying-using-bitlocker.md

@@ -0,0 +1,21 @@
+---
+description: A guide on how to decrypt your system drive using BitLocker
+icon: material/lock-check
+---
+
+# Decrypting a BitLocker encrypted drive
+
+BitLocker is pre-installed and configured to encrypt drives on a large number of retail notebooks, particularly Windows 11 laptops.
+
+To run the `setup.exe` file in the `sources` folder, we will be focusing on decrypting the `C:` drive, sometimes known as the "system" drive.
+
+!!! warning "BitLocker data loss"
+    BitLocker is a powerful encryption tool, and using it improperly may result in data loss. It is safe to follow these instructions, but failure to follow steps may result in loss of data.
+
+1. Run `CMD` (Command Prompt) with **Administrator privileges**
+2. Type `manage-bde -off %SystemDrive%` this will then start BitLocker with the parameters we entered
+    - Many users will see: [ERROR: This volume stores external key(s) that can automatically unlock other volumes.](../../assets/images/bitlocker-error-decrypting.jpg). If this applies to you, type `manage-bde -autounlock - ClearAllKeys %SystemDrive%` to clear the keys. After completion, re-type `manage-bde -off %SystemDrive%` to continue decrypting.
+3. If you got "Decryption is now in progress." you have completed the steps correctly. It will take some time to fully decrypt the drive
+4. You can checkthe progress b
+y typing `manage-bde -status` and finding the `C:` drive and the [percentage encrypted](../../assets/images/bitlocker-decryption-progress.png).
+5. When the decyption percentage reaches "0%" you've successfully decrypted the drive!

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

@@ -0,0 +1,20 @@
+---
+description: How to fix Itunes not recognising Apple device?
+icon: material/apple
+---
+
+**iTunes not recognising your Apple device is a driver issue. Diwbkiad Apple USB Drivers to fix this issue.**
+
+If you're using Atlas and not using Automatic Driver Installation, you will need to install the Apple USB driver yourself.
+
+To fix this issue:
+
+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)
+
+2. Extract (use 7-Zip or Explorer, ignore any errors/warnings) the zipped driver
+
+3. **Right-click** on the `.inf` file :material-arrow-right: **Install**
+
+Alternatively, use [Microsoft PC Manager](https://pcmanager-en.microsoft.com/) to interact with the core of Windows Update to install the Apple USB drivers, and bypass Atlas' Windows Update driver blocks.
+
+If you're experiencing significant issues with drivers, you can also enable Automatic Driver Installation from the Atlas folder.

docs/faq-and-troubleshooting/common-questions/microsoft-store-compatibility.md

@@ -0,0 +1,14 @@
+---
+description: Does Microsoft Store work on AtlasOS?
+icon: material/microsoft
+---
+
+# Does Microsoft Store work on AtlasOS?
+
+**Yes, Microsoft Store is fully functional in Atlas out of the box.**
+
+Microsoft Store has not been altered in Atlas and works out of the box. If you're having troubles with it, we have some steps you can follow to try and fix any issues.
+
+1. Open CMD (Command Prompt) with Administrator Privileges
+2. Type `wsreset.exe` and pres ++enter++
+3. Try opening Microsoft Store

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

@@ -0,0 +1,16 @@
+---
+description: How do I return to Windows after installing AtlasOS?
+icon: material/microsoft-windows
+---
+
+# How do I return to Windows after installing AtlasOS?
+
+**You'll need to reinstall Windows to revert Atlas' modifcation.**
+
+This is required because our installation instructions on our documentation guide you to reinstall Windows (deleting your previous install), then, installing Atlas.
+
+If you need help reinstalling Windows, you can use Google, YouTube or follow our guide on how to install Atlas, but skip out running AME Wizard.
+
+This will get you to a completely stock Windows installation.
+
+🔗 [https://docs.atlasos.net/getting-started/installation/](../../getting-started/installation.md)

docs/faq-and-troubleshooting/removed-features.md

@@ -0,0 +1,30 @@
+---
+description: All Windows features removed by the AtlasOS playbook
+icon: material/file-remove
+---
+
+## :material-delete-off: Features removed from Atlas
+
+Please do keep in mind that Atlas is made for performance and privacy, so many features and services that are not needed have been disabled for these reasons, without any easy way for enabling them. When services or features are taken away, they can cause problems with the apps you use or even with hardware, although generally unlikely. Keep this in mind before installing Atlas.
+
+Atlas gets rid of the following services and features:
+
+- Restore Points and System Reset
+- Telemetry
+- Smart App Control
+- Settings sync
+
+### :material-application: Applications or features uninstalled by default
+
+These can be reinstalled after installation, but are removed by default.
+
+- Many default included Microsoft Store applications
+- Microsoft Update Health Tools
+- Internet Explorer
+- PC Health Check
+- OneDrive
+
+!!! tip
+    If something isn't working, try enabling services or features  inside the [Atlas folder on your Desktop](file://C:/Users/default/Desktop/Atlas), and follow our [Configuration guide](../getting-started/post-installation/drivers/getting-started.md) for more info.
+
+    Atlas gives you the option to enable/disable lots of other options too, which you can also find in the folder above.

docs/faq-and-troubleshooting/testing-nightly-builds.md

@@ -0,0 +1,14 @@
+---
+description: How can I test pre-release builds of AtlasOS?
+icon: material/test-tube
+---
+
+# How can I test pre-release builds of AtlasOS?
+
+**If you wish to take part on testing nightly, pre-release dev builds, you can do so by adding the "Development" Discord role to your profile.**
+
+We love it when people want to help contribute to Atlas. If you don't know how to work with AME Wizard, or aren't that technically minded when it comes to registry. This might be something you can help to contribute to.
+
+We often post announcements to the "Development" Discord role when we need help testing new pre-release builds which are close to public releases. If you're interested, you can [join our Discord server](https://discord.atlasos.net/) and apply the "Development" role to your profile.
+
+<img src="/assets/images/discord-development-role.png" style="border-radius:5px" />

docs/faq-and-troubleshooting/updating-atlas.md

@@ -0,0 +1,10 @@
+---
+description: How do I update AtlasOS to the latest version?
+icon: material/microsoft-windows
+---
+
+# How do I update AtlasOS to the latest version?
+
+**If you're running a version of Atlas prior to v0.3.0, you can not update.**
+
+We will always recommend users wanting to update to the latest version of Atlas to clean install (to avoid issues). If you're running v0.3.0 and want to update to a newer release, you can "dirty update" if you wish - but it may cause issues.

docs/faq-and-troubleshooting/who-is-atlas-for.md

@@ -0,0 +1,12 @@
+---
+description: Who is AtlasOS designed for?
+icon: material/head-check
+---
+
+# Who is Atlas designed for?
+
+**Atlas is for any enthuisast looking to improve the privacy, performance and ease of use of their Windows installation.**
+
+We're on a mission to make a modification which *mostly* everyone can use, with the least amount of drawbacks.
+
+Although Atlas aims for the best compatibility, performance and quality of life fixes possible, you may have to do some troubleshooting with certain Atlas configurations - which isn't always suitable for everyone.