Ultramarine-Linux · nothingneko · Oct 1, 2024 · Oct 1, 2024 · Oct 4, 2024 · Oct 4, 2024
diff --git a/src/content/docs/en/anywhere/chromebook.mdx b/src/content/docs/en/anywhere/chromebook.mdx
@@ -5,12 +5,6 @@ description: "Chromebooks in the Ultramarine Anywhere Initiative"
 
 import Alert from "../../../../components/Docs/Alert.astro";
 
-<Alert type="info">
- This device type is still in the **In Progress Phase**. All information on
- this page is subject to change. Do not follow any instructions unless you know
- what you're doing.
-</Alert>
-
 Chromebooks were an obvious target for Ultramarine Anywhere, despite being mostly
 standard hardware, they have custom EC and strange firmware.
 

diff --git a/src/content/docs/en/anywhere/rpi.mdx b/src/content/docs/en/anywhere/rpi.mdx
@@ -7,58 +7,43 @@ import Alert from "../../../../components/Docs/Alert.astro";
 
 Raspberry Pi is a very popular series of SBCs. They are cheap, easy to get, run Linux well, and have a large ecosystem of expansion cards (Hats and Bonnets) and accessories.
 
-Fedora has upstream support for the Pi 4, 400, and 3. Ultramarine Anywhere intends to extend support to the Zero 2 and 5.
+Raspberry Pi support in Ultramarine Linux is provided in partnership with the Raspberry Pi Foundation.
 
 ## Raspberry Pi 5
 
 <Alert type="info">
- This device type is still in the **Planning Phase**. All information on this
+ This device type is still in the **Testing**. All information on this
  page is subject to change.
 </Alert>
 
 The Raspberry Pi 5 is not currently supported in Fedora. We intend to package the official Raspberry Pi kernel (which should also provide a better experience on the other Pi models.)
 
 ## Raspberry Pi 4 and 400
 
-The Raspberry Pi 4 and 400 have had support in Ultramarine Linux since UM39, and desktop images since UM40. We use the Fedora kernels and boot proccess.
+The Raspberry Pi 4 and 400 have had support in Ultramarine Linux since UM39, and desktop images since UM40. We use the Raspberry Pi Foundation's kernel and Fedora's boot proccess.
 
 ### Notes
 
-- RPi4B has a 1GB and 2GB model, we suggest against running a desktop environment on these (Xfce may be alright.)
-- RPi400 does not have support for WiFi in Ultramarine, this is an upstream issue.
+- RPi4B has a 1GB and 2GB model, we suggest you don't run a desktop environment on these (Xfce may be alright.)
 - The Pi 4 series has native USB boot support. Your experience may be better with a fast USB Drive or SSD connected through an adapter. See [this article](https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#usb-mass-storage-boot) for more info.
 - If using a microSD card, we reccomend using a Class 10 microSD card, your experience will be signifcantly better than lower classes.
 - If using a USB drive, ensure it's USB 3.0 or newer, 2.0 will be a signifcantly worse experience than a microSD.
-- Your storage device will need to be larger than 9GB (the image is 8.59GB) We suggest 16GB so you have space for software.
-
-### Installing
-
-1. Install [Raspberry Pi Imager](https://flathub.org/apps/org.raspberrypi.rpi-imager).
-2. Simply select "Other General Purpose OS" then your Ultramarine Edition of choice.
-3. Insert the storage device into your Pi and boot up! The root filesystem will automatically be expanded.
-4. You will be prompted to set up a user, do this and you're done!.
+- Your storage device will need to be larger than 16GB (the image is ~15GB) We suggest 20GB so you have space for software.
 
 ## Raspberry Pi 3
 
-The Raspberry Pi 3 has had support in Ultramarine Linux since UM39, and desktop images since UM40. We use the Fedora kernels and boot proccess.
+The Raspberry Pi 3 has had support in Ultramarine Linux since UM39, and desktop images since UM40. We use the Raspberry Pi Foundation's kernel and Fedora's boot proccess.
 
 ### Notes
 
-- RPi3B has only 1GB of RAM, and the 3A only has 512MB, we suggest against running a desktop environment (Xfce may be alright.)
-- Your microSD card will need to be larger than 9GB (the image is 8.59GB) We suggest 16GB so you have space for software.
+- RPi3B has only 1GB of RAM, and the 3A only has 512MB, we suggest you don't run a desktop environment (Xfce may be alright.)
+- Your microSD card will need to be larger than 16GB (the image is ~15GB) We suggest 20GB so you have space for software.
 - We reccomend using a Class 10 microSD card, your experience will be signifcantly better than lower classes.
 
-### Installing
-
-1. Grab any aarch64 [Raw Image](https://images.fyralabs.com/images/ultramarine/40/) from our downloads page.
-2. Flash it to your microSD card with [balenaEtcher](https://etcher.io) or [Raspberry Pi Imager](https://flathub.org/apps/org.raspberrypi.rpi-imager)
-3. Insert the storage device into your Pi and boot up! The root filesystem will automatically be expanded.
-4. You will be prompted to set up a user, do this and you're done!.
-
 ## Raspberry Pi Zero 2
 
 <Alert type="info">
- This device type is still in the **Planning Phase**. All information on this
+ This device type is still in the **Testing**. All information on this
  page is subject to change.
 </Alert>
 
@@ -68,3 +53,10 @@ The Raspberry Pi 3 has had support in Ultramarine Linux since UM39, and desktop
  These devices are **Not Supported** due to 32bit CPUs. We include them in this
  page to avoid questions.
 </Alert>
+
+## Installation
+
+1. Install [Raspberry Pi Imager](https://flathub.org/apps/org.raspberrypi.rpi-imager).
+2. Simply select "Other General Purpose OS" then your Ultramarine Edition of choice.
+3. Insert the storage device into your Pi and boot up! The root filesystem will automatically be expanded.
+4. You will be prompted to set up a user, do this and you're done!.
diff --git a/src/content/docs/en/anywhere/xr.mdx b/src/content/docs/en/anywhere/xr.mdx
@@ -10,4 +10,4 @@ import Alert from "../../../../components/Docs/Alert.astro";
  page is subject to change.
 </Alert>
 
-Would use [StardustXR](https://stardustxr.org/). Our packaging effort can be found [here.](https://github.com/Ultramarine-Linux/stardustxr)
+Would use [StardustXR](https://stardustxr.org/). StardustXR is fully packaged in Terra since Fedora 41
diff --git a/src/content/docs/en/community/community.mdx b/src/content/docs/en/community/community.mdx
@@ -10,26 +10,17 @@ Our community (like our code) is open to everyone. Here's some of the official s
 
 ### Discord
 
-<Alert type="info">
-<div class="full-width">
-**Guild Migration**
-
-We are currently in the process of migrating users from the Ultramarine Linux Discord to the Fyra Labs Discord. Please use the Fyra Discord.
-
-</div>
-</Alert>
-
 The Fyra Labs Discord is for all of our projects. We have lively discussions and build great things together. You can get support as a user and as a contributor here.
 
-[Join the Fyra Labs Chat →](https://discord.gg/5fdPuxTg5Q)
+[Join the Fyra Labs Chat →](https://fyralabs.com/discord)
 
 ### Matrix
 
 Fyra Labs is on Matrix! You can access the best of the community inside Matrix!
 
 All of our development channels are bridged, so you can also start here if you'd like to contribute code.
 
-[Join the Fyra Labs Space →](https://matrix.to/#/#hub:fyralabs.com)
+[Join the Fyra Labs Space →](https://fyralabs.com/matrix)
 
 ### Reddit
 

diff --git a/src/content/docs/en/hardware/anywhere.mdx b/src/content/docs/en/hardware/anywhere.mdx
@@ -18,19 +18,17 @@ By contributing to Ultramarine Anywhere, you can help us bring Linux to more dev
 
 ## In Progress
 
-- [Ultramarine Chromebook Edition](/en/anywhere/chromebook)
-
 ## Planned
 
-- [Raspberry Pi 5](/en/anywhere/rpi)
 - [Apple Silicon Macs](/en/anywhere/applesilicon)
 - [XR and Spatial Computing](/en/anywhere/xr)
 - [Android Devices](/en/anywhere/android)
 - [Data Centre, Enterprise, and HPC](/en/anywhere/enterprise)
 
 ## Completed
 
-- [Raspberry Pi 3, 4, and 400](/en/anywhere/rpi)
+- [Raspberry Pi 3 and newer](/en/anywhere/rpi)
+- [Ultramarine Chromebook Edition](/en/anywhere/chromebook)
 
 ## Wishlist
 

diff --git a/src/content/docs/en/hardware/requirements.mdx b/src/content/docs/en/hardware/requirements.mdx
@@ -5,34 +5,34 @@ description: "Minimum Requirements for Ultramarine Linux"
 
 import Alert from "../../../../components/Docs/Alert.astro";
 
-## Recommended Requirements for Standard PCs
+## Recommended Specifications for Standard PCs
 
 These are our suggestions for the most basic (daily-driveable) system:
 
 - 4GB of RAM (8GB or more recommended)
-- 64-bit processor (x86_64/amd64)
-- 16GB of free disk space (24GB or more recommended)
+- Dual Core 64-bit processor (x86_64/amd64)
+- 20GB of free disk space (32GB or more recommended)
 - Internet connection (for downloading the ISO image, updates, and additional drivers)
 - A computer that supports booting from a USB drive
 - A USB drive (for creating the bootable media)
 
 ## Minimum Requirements for Raspberry Pi
 
 - Raspberry Pi 3 or newer
-- 4GB of RAM **OR** 2GB of RAM without a desktop environment
-- 9GB Class 10 MicroSD Card
+- 4GB of RAM **OR** 1GB of RAM without a desktop environment
+- 16GB Class 10 MicroSD Card
 - See the [anywhere page](/en/anywhere/rpi)
 
 ## Minimum Requirements for ARM Devices Using UEFI
 
 - 64-bit processor (aarch64)
-- 4GB or RAM
+- 4GB of RAM
 - 16GB of Storage
 
 ## Minimum Requirements
 
 These requirements are the **_bare minimum_** to run Ultramarine Linux. Using Ultramarine on a computer of this caliber will not be a good time.
 
 - 1gb of RAM
-- 64-bit processor (x86_64 **OR** aarch64)
-- 10GB of disk space
+- Dual Core 64-bit processor (x86_64 **OR** aarch64)
+- 16GB of disk space
diff --git a/src/content/docs/en/hardware/surface.mdx b/src/content/docs/en/hardware/surface.mdx
@@ -5,39 +5,47 @@ description: "Information about Ultramarine Linux on Microsoft Surfaces"
 
 import Alert from "../../../../components/Docs/Alert.astro";
 
-Surfaces require a special kernel to work properly under Ultramarine.
-
-These are currently provided by the Surface Linux team, start by adding their repository
-
-```shell
-sudo dnf config-manager \
- --add-repo=https://pkg.surfacelinux.com/fedora/linux-surface.repo
-```
-
-Then, install the kernel and it's dependencies
-
-```shell
-sudo dnf install --allowerasing kernel-surface iptsd libwacom-surface
-```
-
-If you want to use secure boot, you need to install `surface-secureboot`, enable 3rd party keys in the EFI settings, and enroll the key in cert-manager. This does not work well on some devices, so we recommend disabling secure boot.
-
-<Alert type="info">We intend to make this easier in future releases.</Alert>
-
-Some Surface models may not boot with a stock copy of Ultramarine Linux. If this is the case for your device, you have to install the kernel before leaving the live environment.
-
-1. Ensure your internal storage is mounted, Anaconda should leave it mounted by default.
-
-2. Check the root partition, it should be mounted as `/mnt/sysroot`
-
-3. Chroot into the installed system
-
-```
-sudo chroot /mnt/sysroot
-```
-
-4. Follow the above instructions
-
-5. Run `dracut -f` to make sure the new kernel is installed as the initramfs.
-
-6. Exit the chroot and reboot!
+Microsoft Surface support is provided in partnership with the Linux Surface team.
+
+## Supported Devices
+
+| Device | Surface Image Required? | Notes |
+| ---------------------------- | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Surface Pro 1 | No | |
+| Surface Pro 2 | No | Identical to Pro 1 |
+| Surface Pro 3 | Yes | Boots without, but things may be broken |
+| Surface Pro 4 | Yes | |
+| Surface Pro (5th Generation) | Yes | Nearly identical to Pro 4 |
+| Surface Pro 6 | Yes | Nearly identical to 5th gen |
+| Surface Pro 7 | Yes | |
+| Surface Pro 7+ | Yes | |
+| Surface Pro 8 | Yes | |
+| Surface Pro 9 | Yes | |
+| Surface 3 | Yes | Battery and touch will not work without |
+| Surface Go | No | Cameras and LTE will not work without Surface Kernel |
+| Surface Go 2 | No | Same as Surface Go |
+| Surface Go 3 | No | |
+| Surface Go 4 | Yes | UFS Storage, requires some manual intervention to get working |
+| Surface Book | Yes | Also needs Nvidia drivers |
+| Surface Book 2 | Yes | Also needs Nvidia drivers and Surface DTX Daemon |
+| Surface Book 3 | Yes | Also needs Nvidia drivers and Surface DTX Daemon. Additionally, surface_aggregator and associated kernel modules NEED to be in initramfs |
+| Surface Laptop | Yes | Some thermal issues due to bad sensor readings |
+| Surface Laptop 2 | Yes | surface_aggregator and associated kernel modules NEED to be in initramfs |
+| Surface Laptop 3 | Yes | surface_aggregator and associated kernel modules NEED to be in initramfs |
+| Surface Laptop 4 | Yes | surface_aggregator and associated kernel modules NEED to be in initramfs. Video is VERY unstable on AMD and Intel models |
+| Surface Laptop 5 | Yes | Hibernation and shutdown are broken, ACPI is generally messed up on here. surface_aggregator and associated kernel modules NEED to be in initramfs |
+| Surface Laptop Go | Yes | Touchpad may stop working when resuming from suspend. Intel PSR causes tearing. |
+| Surface Laptop Go 2 | Yes | |
+| Surface Laptop Go 3 | Yes | No data, we assume surface_aggregator is required |
+| Surface Studio | Yes | |
+| Surface Laptop Studio | Yes | GPU may be limited to 10W |
+| Surface Laptop Studio 2 | Yes | |
+
+Please review the [Linux Surface wiki page](https://github.com/linux-surface/linux-surface/wiki) for your device, there may be important information in there.
+
+#### Notes
+
+- We do not and will **NEVER** support the Surface 1, 2, or RT.
+- We do not support the Surface Pro X, and probably won't. If you'd like to change this you can [donate hardware](/en/contributing/contributorguide/#hardware).
+- We do not support either Windows DevKit, and probably won't. If you'd like to change this you can [donate hardware](/en/contributing/contributorguide/#hardware).
+- We do not support the "Copilot+ PC" Surfaces **YET**.