Merge pull request #88 from AerynOS/New-FAQ

FAQ: Re-work FAQ page into its own section

Author: CookieSource

astro.config.mjs

@@ -86,10 +86,21 @@ export default defineConfig({
             { slug: "aerynos" },
             { slug: "aerynos/overview" },
             { slug: "aerynos/philosophy" },
-            { slug: "aerynos/faq" },
             { slug: "aerynos/contribute" },
           ],
         },
+        {
+          label: "FAQ",
+          items: [
+            { slug: "faq" },
+            { slug: "faq/installation" },
+            { slug: "faq/filesystems" },
+            { slug: "faq/aerynos-features" },
+            { slug: "faq/general-faq" },
+            { slug: "faq/socials" },
+            { slug: "faq/lacking-features" },
+          ],
+        },
         {
           label: "Users",
           items: [

src/content/docs/AerynOS/faq.mdx

@@ -0,0 +1,36 @@
+---
+title: AerynOS Features
+lastUpdated: 2026-01-15T12:25:00Z
+description: How to use the key features of AerynOS
+---
+
+# Usage Questions
+
+### How do I make my system check for updates and install them?
+
+```sudo moss sync -u```
+
+This is a short hand form of:
+
+```
+# update the local systems "view" of which packages are available
+sudo moss repo update
+# synchronize the installed state against the list of available packages
+sudo moss sync
+```
+
+### How do I access the rollback feature at boot?
+
+Hold down or mash your Space key repeatedly after your computer starts up.
+
+### How do I verify the integrity of my install states in AerynOS?
+
+```sudo moss state verify```
+
+Tack on ```--help``` to see the options for verify.
+
+### How do I clean out older install states in AerynOS?
+
+```sudo moss state prune```
+
+Tack on ```--help``` to see the options for prune.

src/content/docs/FAQ/aerynos-features.mdx

@@ -0,0 +1,33 @@
+---
+title: Filesystems
+lastUpdated: 2026-01-15T12:25:00Z
+description: Information about filesystem support on AerynOS
+---
+
+# Filesystems
+
+### Why do you recommend the xfs filesystem for the root partition?
+
+[Testing has shown](https://github.com/AerynOS/os-tools/blob/main/moss-filesystem-performance.md) that, due to how moss saves rollback states, xfs is by far the quickest filesystem in practice for AerynOS root partition usage.
+
+We currently do not recommend either ext4 or f2fs root partitions, because testing has shown that they offer very poor performance on the first update (sudo moss sync -u) after a cold start of your computer compared to xfs.
+
+### Do you support installing AerynOS on ext4?
+
+We currently **strongly recommend** that you use **xfs** on your root partition for the best experience with moss and AerynOS.
+
+### Do you support installing AerynOS on f2fs?
+
+We currently **strongly recommend** that you use **xfs** on your root partition for the best experience with moss and AerynOS.
+
+### Do you support installing AerynOS on btrfs?
+
+Not yet
+
+### Do you support installing AerynOS on bcachefs?
+
+Not yet
+
+### Do you support installing AerynOS on ZFS?
+
+Not at this stage. We may or may not decide to support it at some unspecified point in the future, provided we can guarantee that we are legally in the clear to do so.