Ultramarine-Linux · Owen-sz · Oct 4, 2024 · Oct 7, 2024 · Oct 7, 2024 · Oct 7, 2024
diff --git a/src/consts.ts b/src/consts.ts
@@ -88,14 +88,17 @@ export const SIDEBAR: Sidebar = {
       { text: "Errata", link: "en/release/errata" },
       { text: "Differences with Fedora", link: "en/release/diff-fedora" },
     ],
-    // Chromebook: [
-    //   { text: "Getting Started", link: "en/chromebook/chromebook" },
-    //   { text: "Getting Chromebook Edition", link: "en/chromebook/getting" },
-    //   { text: "Installing to a Chromebook", link: "en/chromebook/preparing" },
-    //   { text: "Post-Install", link: "en/chromebook/postinstall" },
-    //   { text: "ARM Chromebooks (Beta)", link: "en/chromebook/armbeta" },
-    //   { text: "Terminology", link: "en/chromebook/terminology" },
-    // ],
+    Chromebook: [
+      { text: "Getting Started", link: "en/chromebook/chromebook" },
+      { text: "Getting Chromebook Edition", link: "en/chromebook/getting" },
+      { text: "Installing", link: "en/chromebook/installing" },
+      {
+        text: "Troubleshooting and FAQ",
+        link: "en/chromebook/faq-and-troubleshooting",
+      },
+      { text: "ARM Chromebooks (Beta)", link: "en/chromebook/armbeta" },
+      { text: "Terminology", link: "en/chromebook/terminology" },
+    ],
 
     Development: [
       {

diff --git a/src/content/docs/en/anywhere/chromebook.mdx b/src/content/docs/en/anywhere/chromebook.mdx
@@ -152,7 +152,7 @@ cgpt add -i <partition number> -t kernel -P 15 -T 1 -S 1 /dev/sdX
 11. Done!
 
 <Alert type="warning">
-  Once Ultramarine has been sucessfully installed onto your Chromebook's internal disk, rebooting will take you back to the ChromeOS recovery screen. To boot to Ultramarine, select 'Boot to Internal Disk' or press <kbd>Ctrl</kbd>+<kbd>D</kbd>
+Once Ultramarine has been sucessfully installed onto your Chromebook's internal disk, rebooting will take you back to the ChromeOS recovery screen. To boot to Ultramarine, select 'Boot to Internal Disk' or press <kbd>Ctrl</kbd>+<kbd>D</kbd>
 </Alert>
 
 ## ARM

diff --git a/src/content/docs/en/chromebook/armbeta.mdx b/src/content/docs/en/chromebook/armbeta.mdx
@@ -51,7 +51,8 @@ All Oak (mt8173) family Chromebooks:
 
 <Alert type="warning">
   This family has **NO WORKING GPU**. Ultramarine may never fully support this
-  platform, but stay tuned as things may change.
+  platform, but stay tuned as things may change. We are working on rebuilding
+  these images, and we may not have one available at the time of application.
 </Alert>
 
 | Model name/number                            | Codename |
@@ -74,18 +75,20 @@ Source: https://wiki.postmarketos.org/wiki/Google_Oak_Chromebook_(google-oak)
 All Trogdor (sc7180) family Chromebooks:
 
 <Alert type="warning">
-  This family has **NO WORKING WiFi**. We are working on debugging this, but have a lot of other projects at the moment. Join our discord or check back to follow progress, or become a tester and run off an SD Card/Ethernet adaptor if you desire networking and Ultramarine.
+  This family has **NO WORKING WiFi**. We are activly working to debug this, but
+  is not a huge priotiry at the moment. We are working on rebuilding these
+  images, and we may not have one available at the time of application.
 </Alert>
 
-| Model name/number                             |   Codename    |
+| Model name/number                             | Codename      |
 | --------------------------------------------- | ------------- |
 | Acer Chromebook 511                           | limozeen      |
 | Acer Chromebook Spin 513                      | lazor         |
 | Dynabook Chromebook C1                        | pompom        |
 | HP Fortis 11 G9 Q Chromebook                  | kingoftown    |
 | Libera-Merdeka Chromebook C100/C110/C120/C150 | pazquel       |
 | Orbic Chromebook 4G                           | pazquel       |
-| Acer Chromebook Tab 510 	                    | quackingstick |
+| Acer Chromebook Tab 510                       | quackingstick |
 | HP Chromebook X2                              | coachz        |
 | Lenovo IdeaPad Duet 3                         | wormdingler   |
 | Lenovo IdeaPad Duet 5                         | homestar      |
@@ -96,4 +99,4 @@ Follow-up instructions, guide, and dedicated discord channel will be provided af
 
 #### [Next Up: Terminology →](terminology)
 
-#### [← Back To: Post-Install](postinstall)
+#### [← Back To: Troubleshooting and FAQ](faq-and-troubleshooting)
diff --git a/src/content/docs/en/chromebook/chromebook.mdx b/src/content/docs/en/chromebook/chromebook.mdx
@@ -9,8 +9,8 @@ import Alert from "../../../../components/Docs/Alert.astro";
 
 With the help from out friends over at the [Chrultrabook Project](https://docs.chrultrabook.com/), we built a no-hassle way to boot full Ultramarine Linux onto your Chromebook!
 
-These pages will get you everything you need to know about what Ultramarine Chromebook is, how it works, how you can install it, and even how you can help us out.
+These pages will provide you everything you need to know about what Ultramarine Chromebook Edition is, how it works, how you can install it, and even how you can help us out.
 
-If you would like more info about Ultramarine Chromebook and it's release, take a peak at the [Release post](link)
+If you would like more info about Ultramarine Chromebook and it's release, take a peak at the [Release post](https://blog.fyralabs.com/ultramarine-chromebook-edition-is-here)
 
 #### [Next Up: Getting Chromebook Edition →](getting)
diff --git a/src/content/docs/en/chromebook/faq-and-troubleshooting.mdx b/src/content/docs/en/chromebook/faq-and-troubleshooting.mdx
@@ -0,0 +1,93 @@
+---
+title: Troubleshooting and FAQs
+description: "Troubleshooting tips and tricks, and FAQs"
+---
+
+import Alert from "../../../../components/Docs/Alert.astro";
+
+## Troubleshooting
+
+<Alert type="warning">
+  If your issue still persists after reading this page, hop into [our
+  chats](/en/community/community) and make a support forum post.
+</Alert>
+
+### Chromebook fails to boot to internal disk
+
+Assuming 'Boot to Internal Disk', or pressing <kbd>Ctrl</kbd>+<kbd>D</kbd> does not fully boot (usually only to Submarine, the boot entries screen before Ultramarine boots), the device has probably died. Plug in your Chromebook.
+
+### Keyboard is not properly mapped
+
+Try re-installing the cros-keyboard-map package. Simply run ` sudo dnf install cros-keyboard-remap`. If this does not work, try running WeirdTreeThing's [keyd script](https://github.com/WeirdTreeThing/cros-keyboard-map).
+
+### Chromebook Audio Doesn't Work
+
+This should not happen unless you have unsupported speakers, but if it does, try running WeirdTreeThing's [audio script](https://github.com/WeirdTreeThing/chromebook-linux-audio) manually.
+
+You may have an audio device unsupported by the audio script by default (max98357a Sound controller). If you would like to enable audio on here, run the script manually and follow the prompts to enable audio.
+
+### USBC/Thunderbolt doesn't work
+
+You probably have an 11th or 12th gen Intel CPU. We have a systemd service packaged in terra that will fix this:
+
+```
+sudo dnf install chromebook-usbc-fix
+```
+your USBC ports should immediatly work after package installation. If it does not, try a reboot. If it still doesn't work:
+
+```
+sudo systemctl enable chromebook-usbc-fix
+```
+This package may also work on 13th gen or higher platforms.
+
+<Alert type="warning">
+  max98357a, and any other audio devices requiring ```--force-avs-install``` is
+  not recommended to enable, and support will not be given to damaged speakers.
+  If you really want to proceed, do not raise your speakers volume high or they
+  will get damaged.
+</Alert>
+
+## FAQs
+
+### Why Doesn’t [Insert Hardware Feature] Work?
+
+All hardware should work on almost every supported Chromebook model, but some specific Chromebooks may have some missing features (ex. Drallion, Sarien, and Arcada have a Wilco (Dell Enterprise) EC, and may have missing features).
+
+### Is this legal?
+
+Yes, it is perfectly legal. Chromebooks and ChromeOS are backed by the [Chromium Projects' ChromiumOS](https://www.chromium.org/chromium-os/}). All information on how to mod Chromebooks is on this site, and open to anyone to use.
+
+### Why not just run [MrChromebox's Firmware Utility Script?](https://mrchromebox.tech/#fwscript)
+
+The goal here is to be as easy and safe to use as possible. It is also easier to go back to ChromeOS if you keep the stock firmware. With that being said, we fully support the use of mrchromebox's script, it has many great use cases.
+
+### Will this make my Chromebook faster?
+
+It often does, as Ultramarine can be more lightweight then ChromeOS, but we do not guarantee a preformance gain vs ChromeOS.
+If you are using an older/slower Chromebook and want to maximize performance, we reccomend using Xfce or Flagship edition.
+
+### Should I Buy a Chromebook Instead of a Regular Laptop Now?
+
+Generally, it is reccomended not to, however you can get really good Chromebook deals if you know where to look. Keep in mind they will by nature be less stable, and more involved then a regular laptop. A good rule of thumb is to always have a regular laptop handy incase you need it.
+
+### I Thought Ultramarine Used Btrfs?
+
+Ultramarine proper does, but due to Btrfs's advanced features, it is not very good on eMMC storage (used by most Chromebooks). We use F2Fs (Flash-Friendly file system) to prolong the life of eMMC as much as we can. We plan on adding more file system options in the near future.
+
+### This Installer Looks Different, What Is It?
+
+We are using our in-house installer [Readymade](https://github.com/FyraLabs/readymade). We always intended to use our own installer in Ultramarine, but Chromebook Edition is the first to use it due to the limitations of other installers. Chromebook Edition uses an early version of Readymade with pretty basic features, enough for a Chromeobok install. We hope to have a more complete build of Readymade for Ultramarine 41.
+
+#### Ultramarine Chromebook Edition Known Issues
+
+Found an issue? [Let us know](/en/community/community)
+
+| Model name/number | Codename | Issue | Cause | Fix? |
+| ----------------- | -------- | ----- | ----- | ---- |
+|         Dell Latitude 7410 Enterprise Chromebook          |     Drallion     |    No working keyboard backlight or touchscreen   |   Dell Wilco EC firmware    |    x  |
+| Dell Latitude 5300 2-in-1 Chromebook Enterprise | Arcada | No working keyboard backlight or touchscreen | Dell Wilco EC Firmware | x |
+| All 11th and 12th gen Intel Chromebooks | N/A | No working usbc/thunderbolt | unknown | [yes](https://docs.chrultrabook.com/docs/installing/post-install.html#fixing-usb-c-on-tigerlake-and-alderlake) | 
+
+#### [Next Up: ARM Chromebooks (Beta) →](armbeta)
+
+#### [← Back To: Installing](installing)
diff --git a/src/content/docs/en/chromebook/getting.mdx b/src/content/docs/en/chromebook/getting.mdx
@@ -16,9 +16,9 @@ Ultramarine Chromebook comes in 4 variants:
 - **Flagship Edition**: Our default and most popular variant. Choose Flagship if you'd like a familiar and stylish experience.
 - **KDE Edition**: Our second most popular variant. Choose KDE if you'd like a simply customisable experience.
 - **GNOME Edition**: Elegant and Modern. Choose GNOME if you'd like a simple, unique experience.
-- **Pantheon Edition**: Thoughtful and graceful. Choose Pantheon if you'd like a refined experience.
+- **Xfce Edition**: Lightweight and Configurable. Choose Xfce if you’d like a lighter experience.
 
-Ultramarine Linux is distributed with image files available for download from [our website](https://ultramarine-linux.org/download/chromebook).
+Ultramarine Chromebook Edition is distributed with image files available for download from [our website](https://ultramarine-linux.org/download/chromebook).
 
 <Alert type="warning">
   Fyra Labs cannot guarantee the safety or quality of images downloaded from
@@ -62,20 +62,33 @@ CertUtil -hashfile PATH\TO\ULTRAMARINE.ISO SHA256
 # Open the CHECKSUM file with Notepad and compare the checksum
 ```
 
-## Creating the Installer
+## Creating the Installer on Windows, macOS, or Linux
 
 ### Download [balenaEtcher](https://www.balena.io/etcher/) to create a bootable media from the img image.
 
 ![](/assets/balenaetcher.png)
 
-Simply select the img file, a device to use for the installer, and click flash.
+After downloading Ultramarine Chromebook, select the img file, a device to use for the installer, and click flash.
 
-#### [Next Up: Installing to a Chromebook →](preparing)
+## Creating the installer on ChromeOS
+
+### Download the [Chromebook Recovery Utility extension](https://chromewebstore.google.com/detail/chromebook-recovery-utili/pocpnlppkickgojjlmhdmidojbmbodfm) from the Chrome Web Store
+
+![](/assets/Chromebook-Recovery-Utility.png)
+
+1. Download the Ultramarine Chromebook image
+2. Navigate to the image, and change the '.img' to '.bin'
+3. Open the Chromebook Recovery Utility extension
+4. Click the 'settings' icon in the top right corner, and select 'Use Local Image'
+5. Navigate to and select your Ultramarine Chromebook .bin image, and select 'OPEN'
+6. Insert and select the instalation media you would like to use under the dropdown
+7. Select 'Continue'
+8. Disregard the warning, then press 'Create now'
+
+#### [Next Up: Installing →](installing)
 
 #### [← Back To: Getting Started](chromebook)
 
 ## Footnotes
 
-- The Anaconda installer is very complex and hard to work with, we are working on a new installer that is easier to use and more reliable.
-- Since Fedora 37, Fedora's official support for the Pantheon desktop environment has been dropped due to compatibility issues and the Pantheon port is now maintained by the Ultramarine Linux team. This means that the Pantheon desktop environment is only available through Ultramarine Linux, or Fedora with Terra enabled.
 - Ultramarine's Budgie edition provides a close to stock Budgie experience, with a custom theme. Unlike Fedora's Budgie Spin, which provides a completely custom layout and experience.