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
@@ -95,14 +95,26 @@ 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/arm" },
+      { text: "Terminology", link: "en/chromebook/terminology" },
+    ],
+
+    Development: [
+      {
+        text: "Developing for Ultramarine",
+        link: "en/development/developing-for-ultramarine",
+      },
+      { text: "Using Andaman", link: "en/development/anda" },
+      { text: "UX Guidelines", link: "en/development/ux-guide" },
+    ],
   },
   de: {
     Introduction: [{ text: "Welcome", link: "de/welcome" }],

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 successfully 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/arm.mdx b/src/content/docs/en/chromebook/arm.mdx
@@ -0,0 +1,37 @@
+---
+title: ARM Chromebooks
+description: "Preview images for certain ARM chromebooks"
+---
+
+import Alert from "../../../../components/Docs/Alert.astro";
+
+NOTE - Not all ARM devices are currently supported. The images we provide are previews and may have issues, proceed at your own risk.
+
+# Supported Devices
+
+Currently supported ARM Chromebooks (a * means Fyra Labs has tested these images on a device in this family):
+
+Supported MediaTek series:
+- [mt8195](https://wiki.postmarketos.org/wiki/MediaTek_Kompanio_1200_(MT8195))
+- *[mt8192 (Asurada)](https://wiki.postmarketos.org/wiki/Google_Asurada_Chromebook_(google-asurada))
+- [mt8186 (Corsola)](https://wiki.postmarketos.org/wiki/Google_Corsola_Chromebook_(google-corsola))
+- *[mt8183 (Kukui)](https://wiki.postmarketos.org/wiki/Google_Kukui_Chromebook_(google-kukui))
+- [mt8173C](https://wiki.postmarketos.org/wiki/MediaTek_Kompanio_500_(MT8173))
+
+Supported Snapdragon series:
+
+- [sc7180 (Trogdor)](https://wiki.postmarketos.org/wiki/Google_Trogdor_Chromebook_(google-trogdor))
+
+# Usage
+
+[TODO]
+
+# Known Issues
+
+- mt8183 devices may emit a loud beep for 15 seconds if not properly sleeping/shut down
+- mt8192 devices may have issues with sleep
+- Cellular equipped sc7180 devices cellular may not work
+
+#### [Next Up: Terminology →](terminology)
+
+#### [← Back To: Troubleshooting and FAQ](faq-and-troubleshooting)
diff --git a/src/content/docs/en/chromebook/armbeta.mdx b/src/content/docs/en/chromebook/armbeta.mdx
diff --git a/src/content/docs/en/chromebook/chromebook.mdx b/src/content/docs/en/chromebook/chromebook.mdx
@@ -7,10 +7,10 @@ import Alert from "../../../../components/Docs/Alert.astro";
 
 ### Welcome to Ultramarine Chromebook Edition!
 
-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!
+With the help from out friends over at the [Chrultrabook Project](https://docs.chrultrabook.com/), we built a no-hassle way to install Ultramarine 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 everything you need to know about installing and using Ultramarine on Chromebooks.
 
-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,97 @@
+---
+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 this command:
+
+```
+sudo systemctl enable cros-keyboard-map
+```
+
+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.
+
+<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>
+
+### USBC/Thunderbolt Doesn’t Work
+
+Try restarting the systemd service:
+
+```
+sudo systemctl restart chromebook-usbc-fix
+```
+
+## 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.
+
+### Will the Installer Boot Through a USB 2.0/3.0 Adaptor/Hub?
+
+Yes.
+
+### 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?
+
+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 Edition.
+
+### Should I Buy a Chromebook Instead of a Regular Laptop Now?
+
+Generally, it is recommended 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.
+
+### This Installer Looks Different, What Is It?
+
+We are using our in-house installer [Readymade](https://github.com/FyraLabs/readymade).
+
+### What Is This Chrultrabook Tools App?
+
+An application to interact with your Chromebook's hardware, provided through Terra.
+More info can be found [here](https://github.com/death7654/Chrultrabook-Tools).
+
+#### 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 |
+
+#### [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
@@ -18,7 +18,7 @@ Ultramarine Chromebook comes in 4 variants:
 - **Budgie Edition**: A familiar and stylish experience with a bit of flair.
 - **GNOME Edition**: A simple, elegant, and intuitive desktop with a large ecosystem of apps and extensions.
 
-Ultramarine Linux is distributed with image files available for download from [our website](https://ultramarine-linux.org/download/chromebook).
+Ultramarine for Chromebooks 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,29 @@ 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
 
-#### [← Back To: Getting Started](chromebook)
+### 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)
 
-## Footnotes
+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'
 
-- 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.
+#### [Next Up: Installing →](installing)
+
+#### [← Back To: Getting Started](chromebook)