From b7edc3df302b0f37e0db5ab47a4c8b93fc03f254 Mon Sep 17 00:00:00 2001
From: Hector Martin <marcan@fedoraproject.org>
Date: Dec 18 2023 14:22:00 +0000
Subject: Fill in initial docs pages


---

diff --git a/modules/ROOT/pages/faq.adoc b/modules/ROOT/pages/faq.adoc
index efd3aed..bb7381a 100644
--- a/modules/ROOT/pages/faq.adoc
+++ b/modules/ROOT/pages/faq.adoc
@@ -6,9 +6,37 @@
 
 {variant-name} provides similar experiences to upstream Fedora Linux, just tailored to the Apple Silicon Mac hardware platform.
 
-=== How can I check the version number of an installed package?
+=== What variant should I choose?
 
-You can simply use:
+The KDE Plasma variant receives the most testing and platform integration work and is the recommended option for users new to Fedora Linux and Linux on Apple Silicon platforms. The GNOME variant is also fully supported, for users who prefer that desktop environment. Advanced users who want an alternate desktop environment may choose the Minimal variant and manually configure their system to their liking, while those who want to set up an Apple Silicon-based Linux server may prefer the Server variant.
 
- $ rpm -q <package>
+=== Is Xorg supported?
+
+The native Xorg server is available as a manual install, but its use is not recommended as it has several known bugs and deficencies when used on Apple Silicon platforms. As upstream Xorg development has slowed down, we only support Wayland-based desktop environments. Please do not file bugs related to usage of the Xorg server.
+
+XWayland is fully supported as a transition technology to use native X11 apps on a Wayland desktop.
+
+== HOWTOs
+
+=== How do I access protected content in browsers (Widevine DRM)
+
+Run `sudo widevine-installer` and follow the prompts. Note that Widevine is third-party software not officially affiliated nor endorsed by the Fedora Project or Asahi Linux.
+
+In addition, Netflix requires manual browser configuration to work. You need to install a browser extension to override your User-Agent for specific sites, and set the user agent for Netflix to:
+
+ Mozilla/5.0 (X11; CrOS aarch64 15329.44.0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/111.0.0.0 Safari/537.36
+
+=== How do I enable playback of restricted codecs (H.265/HEVC, AC-4, etc.)
+
+See xref:quick-docs::rpmfusion-setup.adoc[Enabling the RPM Fusion repositories].
+
+== Common issues
+
+=== Chromium and Chromium/Electron-based apps stop working after an upgrade
+
+Run the following command to resolve the issue:
+
+ find $HOME/.config -name GPUCache -type d -exec /bin/rm -rf {} +
+
+This is caused by an https://bugs.chromium.org/p/chromium/issues/detail?id=1442633[upstream Chromium bug]. This step will be necessary after certain upgrades until the fix is released for the various Chromium-based frameworks and applications built on them.
 
diff --git a/modules/ROOT/pages/index.adoc b/modules/ROOT/pages/index.adoc
index ad36ddb..6473114 100644
--- a/modules/ROOT/pages/index.adoc
+++ b/modules/ROOT/pages/index.adoc
@@ -2,8 +2,8 @@
 
 Welcome to the {variant-name} user guide!
 
-_{variant-name}_ is an adaptation of Fedora Linux for Apple Silicon Macintosh computers.
-It aims to be extremely stable and reliable.
+_{variant-name}_ is an adaptation of Fedora Linux for Apple Silicon Mac computers.
+It aims to offer a stable and reliable experience while bringing you the latest improvements in platform support.
 
 [[introduction]]
 == Introduction to {variant-name}
@@ -18,6 +18,7 @@ In most cases, {variant-name} behaves like a standard Fedora Linux installation,
 This guide covers those areas where {variant-name} differs from a standard Fedora Linux, including:
 
 * xref:installation.adoc[OS installation]
+* xref:faq.adoc[FAQ]
 
 [[known-bugs]]
 == Known bugs
diff --git a/modules/ROOT/pages/installation.adoc b/modules/ROOT/pages/installation.adoc
index a57b67c..a7ba831 100644
--- a/modules/ROOT/pages/installation.adoc
+++ b/modules/ROOT/pages/installation.adoc
@@ -1,11 +1,17 @@
 = Installing {variant-name}
 
-{variant-name} is installed from macOS.
+{variant-name} is installed from macOS. The minimum supported macOS versions are 13.5 and 14.2. Due to macOS issues outside of our control, you may be prompted to upgrade to 14.2 if you have an intermediate version.
 
-Open up the terminal and run the following as a regular user:
+To install the latest release build, open up the terminal and run the following as a regular user:
 
 ....
-$ curl https://fedora-asahi-remix.org/install | sh
+$ curl https://alx.sh | sh
 ....
 
 Follow the prompts from the script and you'll have Fedora Asahi Remix installed in no time.
+
+If you want to install a nightly build and have more options available (e.g. Rawhide images), use this command instead:
+
+....
+$ curl https://fedora-asahi-remix.org/install | sh
+....