[Work in progress] Hardware reorganization

docs/user/hardware/compatibility/_category_.json

@@ -1,5 +1,5 @@
 {
-  "label": "Compatibility",
+  "label": "Compatibility lists",
   "link": {
     "type": "generated-index"
   }

docs/user/hardware/compatibility/midi-keyboards.md

@@ -0,0 +1,17 @@
+---
+title: MIDI keyboards
+summary: List of known-working MIDI keyboards on Solus
+hide_table_of_contents: true
+---
+
+:::info
+
+This list is not exhaustive. Other devices are also compatible with Solus, even if they are not listed here.
+
+:::
+
+Users have reported that the following MIDI keyboards work properly with Solus.
+
+| Brand   | Device    | Notes |
+| :------ | :-------- | :---- |
+| M-Audio | KeyRig 49 | -     |

docs/user/hardware/compatibility/printers-scanners.md

@@ -0,0 +1,39 @@
+---
+title: Printers and scanners
+summary: List of known-working printers and scanners on Solus
+hide_table_of_contents: true
+---
+
+:::info
+
+This list is not exhaustive. Other devices are also compatible with Solus, even if they are not listed here.
+
+:::
+
+Users have reported that the following printers and scanners work properly with Solus.
+
+| Brand   | Device      | Notes |
+| :------ | :---------- | :---- |
+| Brother | DCP-135C    | -     |
+| Brother | DCP-1510    | -     |
+| Brother | DCP-1512    | -     |
+| Brother | DCP-1610W   | -     |
+| Brother | DCP-7010    | -     |
+| Brother | DCP-7060D   | -     |
+| Brother | DCP-L2520DW | -     |
+| Brother | HL-1210W    | -     |
+| Brother | HL-1212W    | -     |
+| Brother | HL-2220     | -     |
+| Brother | HL-L2315DW  | -     |
+| Brother | HL-L2320D   | -     |
+| Brother | HL-L2360D   | -     |
+| Brother | HL-L2375DW  | -     |
+| Brother | MFC-1910W   | -     |
+| Brother | MFC-440CN   | -     |
+| Brother | MFC-9130CW  | -     |
+| Brother | MFC-9330CDW | -     |
+| Brother | MFC-J220    | -     |
+| Brother | MFC-J480DW  | -     |
+| Brother | MFC-L2700DW | -     |
+| Brother | MFC-L2703DW | -     |
+| Brother | MFC-L2740DW | -     |

docs/user/hardware/compatibility/wifi.md

@@ -1,73 +1,61 @@
 ---
-title: WiFi
-summary:
+title: Wi-Fi chipsets
+summary: List of known-working Wi-Fi chipsets on Solus
+hide_table_of_contents: true
 ---
 
-# WiFi
-
-The following wireless chipsets have been tested and/or suggested to function correctly by our users.
-
-This list should not suggest that _only_- such devices listed below are compatible with Solus, as there may be devices not listed below that are in fact compatible.
-
-## Atheros
-
-- Atheros AR5B97
-- Atheros AR242x
-- Atheros AR542x
-- Atheros AR928X
-- Atheros AR8161
-- Atheros AR9285
-- Atheros AR9287
-- Atheros AR9462
-- Atheros AR9485
-- Atheros AR9485WB-EG
-- Atheros QCA9565 / AR9565
-
-## Broadcom
-
-- Broadcom BCM4312
-- Broadcom BCM4313
-- Broadcom BCM4322
-- Broadcom BCM4324
-- Broadcom BCM4331
-- Broadcom BCM4365
-- Broadcom BCM57785
-
-## Netgear
-
-- Netgear WPN111
-
-## Intel
-
-- Intel AC3160
-- Intel AC7265
-- Intel Centrino Advanced-N 6200
-- Intel Centrino Advanced-N 6205
-- Intel Centrino Advanced-N 6235
-- Intel Centrino Ultimate-N 6300
-- Intel Centrino Wireless-N 2230
-- Intel PRO/Wireless 3945ABG
-- Intel PRO/Wireless 4965 AG or AGN
-- Intel Ultimate N WiFi Link 5300
-- Intel WiFi Link 5100
-- Intel Wireless 8265 / 8275
-
-## Ralink
-
-- Ralink RT5390
-- Ralink RT3070
-
-## Realtek
-
-- Realtek RTL8101E/RTL8102E
-- Realtek RTL8111/8168B
-- Realtek RTL8169
-- Realtek RTL8179
-- Realtek RTL8187SE
-- Realtek RTL8188CE
-- Realtek RTL8188CUS
-- Realtek RTL8191SEvB
-- Realtek RTL8192ce
-- Realtek RTL8723BE
-- Realtek RTL8723DE
-- Realtek RTL8821CD
+:::info
+
+This list is not exhaustive. Other devices are also compatible with Solus, even if they are not listed here.
+
+:::
+
+Users have reported that the following wireless chipsets work properly with Solus.
+
+| Brand     | Chipset                         | Notes |
+| :-------- | :------------------------------ | :---- |
+| Atheros   | AR5B97                          | -     |
+|           | AR242x                          | -     |
+|           | AR542x                          | -     |
+|           | AR928X                          | -     |
+|           | AR8161                          | -     |
+|           | AR9285                          | -     |
+|           | AR9287                          | -     |
+|           | AR9462                          | -     |
+|           | AR9485                          | -     |
+|           | AR9485WB-EG                     | -     |
+|           | QCA9565 / AR9565                | -     |
+| Broadcom  | BCM4312                         | -     |
+|           | BCM4313                         | -     |
+|           | BCM4322                         | -     |
+|           | BCM4324                         | -     |
+|           | BCM4331                         | -     |
+|           | BCM4365                         | -     |
+|           | BCM57785                        | -     |
+| Netgear   | WPN111                          | -     |
+| Intel     | AC3160                          | -     |
+|           | AC7265                          | -     |
+|           | Centrino Advanced-N 6200        | -     |
+|           | Centrino Advanced-N 6205        | -     |
+|           | Centrino Advanced-N 6235        | -     |
+|           | Centrino Ultimate-N 6300        | -     |
+|           | Centrino Wireless-N 2230        | -     |
+|           | PRO/Wireless 3945ABG            | -     |
+|           | PRO/Wireless 4965 AG or AGN     | -     |
+|           | Ultimate N WiFi Link 5300       | -     |
+|           | WiFi Link 5100                  | -     |
+|           | Wireless 8265 / 8275            | -     |
+| Ralink    | RT5390                          | -     |
+|           | RT3070                          | -     |
+| Realtek   | RTL8101E/RTL8102E               | -     |
+|           | RTL8111/8168B                   | -     |
+|           | RTL8169                         | -     |
+|           | RTL8179                         | -     |
+|           | RTL8187SE                       | -     |
+|           | RTL8188CE                       | -     |
+|           | RTL8188CUS                      | -     |
+|           | RTL8191SEvB                     | -     |
+|           | RTL8192ce                       | -     |
+|           | RTL8723BE                       | -     |
+|           | RTL8723DE                       | -     |
+|           | RTL8821CD                       | -     |

docs/user/hardware/gpus/index.md

@@ -0,0 +1,18 @@
+---
+title: Graphics cards
+summary: Guide to using graphics cards on Solus.
+---
+
+Most AMD and Intel graphics cards work automatically on Solus. If your system displays correctly and applications run well, you usually do not need to install anything else.
+
+Solus has an open-source driver for NVIDIA cards (Nouveau) which is appropriate for basic usage. If you want to use your NVIDIA card to play games or for other compute tasks, install the proprietary NVIDIA driver for best performance.
+
+## Overview of GPU drivers in Linux
+
+Linux graphics drivers are split into components that do different jobs:
+
+| Component                      | Description                                                                                                                           |
+| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
+| Direct rendering manager (DRM) | Kernel component that controls the hardware. Provides a low-level interface for rendering and display                                 |
+| User-space renderers           | OpenGL and Vulkan libraries that applications use to render. The Mesa project provides OpenGL and Vulkan for most Intel and AMD GPUs. |
+| Display server drivers         | Exposes certain features to the X.Org server. Wayland compositors typically use DRM and Mesa directly.                                |

docs/user/hardware/gpus/nvidia-drivers.md

@@ -0,0 +1,38 @@
+---
+title: Install the NVIDIA proprietary drivers
+summary: Configure the NVIDIA proprietary drivers on Solus to improve performance for games and other compute tasks.
+---
+
+Solus has an open-source driver for NVIDIA cards (Nouveau) which is appropriate for basic usage. If you want to use your NVIDIA card to play games or for other compute tasks, install the proprietary NVIDIA driver for best performance.
+
+## Before you start
+
+To install the correct driver, check:
+
+- Which NVIDIA graphics card you have.
+- Which kernel you are running (current or LTS) by running the command `uname -r`.
+
+## Procedure
+
+To install the proprietary NVIDIA drivers in Solus, do the following steps:
+
+1. Open **GNOME Software** or **Discover** (Solus Plasma).
+
+1. Search for <kbd>nvidia driver</kbd>.
+
+1. Install the apropriate driver according to your kernel and graphics card.
+
+   The following table lists the available Nvidia drivers in Solus:
+
+   | Your Graphics Card                    | Your Kernel | Driver to Install                              |
+   | :------------------------------------ | :---------- | :--------------------------------------------- |
+   | Maxwell (GeForce 900 series) or newer | `current`   | **NVIDIA Graphics Driver**                     |
+   |                                       | `lts`       | **NVIDIA Graphics Driver (LTS Kernel)**        |
+   | Kepler (GeForce 600/700 series)       | `current`   | **NVIDIA 470.xx Graphics Driver**              |
+   |                                       | `lts`       | **NVIDIA 470.xx Graphics Driver (LTS Kernel)** |
+
+1. If you plan to play games using Steam or Wine/Lutris, install the 32-bit libraries.
+
+   - In GNOME software, under **Add-ons** install **32bit libraries for NVIDIA binary driver**.
+
+1. Restart your computer.

docs/user/hardware/index.md

@@ -1,67 +1,13 @@
 ---
 title: Hardware
-summary: Guide to using additional hardware on Solus
+summary: Guide to using additional hardware on Solus.
 ---
 
-# Hardware
+Solus is compatible with most hardware, such as CPUs, networking cards, and storage drives, right out of the box.
 
-## Preinstalled drivers
+However, some hardware, such as certain graphics cards or specialized peripherals, may require proprietary drivers or additional configuration to work correctly.
 
-The vast majority of hardware on Linux is supported by driver modules included with the Linux Kernel. This includes things like:
+This section provides guides and compatibility information, including:
 
-- CPUs (AMD, Intel)
-- Networking
-- PCI and PCI Express
-- Storage
-- USB
-
-The purpose of this documentation is to help you find drivers for hardware that is not directly supported or requires additional configuration to be used on Solus.
-
-### GPUs
-
-The situations with GPU drivers on Linux is a little complicated. Each driver is actually broken up into multiple pieces:
-
-- **Direct Rendering Manager (DRM)**
-  This is the part of the driver provided by the Linux kernel and provides just enough functionality to allow other drivers to access the hardware and render to a connected display.
-  Linux provides support for AMD, Intel, and NVIDIA GPUs in this basic capacity.
-- **OpenGL driver**
-  This part of the driver is needed for OpenGL applications. AMD and Intel are fully supported on Linux through Mesa, and do not need further drivers.
-- **Vulkan driver**
-  This part of the driver is needed for Vulkan applications. AMD and Intel are fully supported on Linux through Mesa, and do not need further drivers.
-- **Xorg driver**
-  In order to expose certain features to the Xorg Server, AMD and Intel have additional drivers which may be needed for things like variable refresh rate or multiple display support.
-
-Unfortunately for NVIDIA users, the situation gets a little complicated. Linux has two sets of drivers for NVIDIA GPUs:
-
-- **Nouveau**
-  This is the open-source driver for NVIDIA GPUs. It consists of a DRM driver provided by the Linux kernel, OpenGL drivers (nvc0, nv50) from Mesa, and an Xorg driver (xorg-driver-video-nouveau).
-  Device support for these drivers has historically lagged behind the NVIDIA proprietary drivers and likely will not support newer hardware and does not include Vulkan support.
-  Performance of this driver also typically lags behind the proprietary drivers.
-- **NVIDIA proprietary drivers**
-  This is the closed-source driver provided directly by NVIDIA. It consists of a DRM driver module for the kernel, OpenGL and Vulkan drivers for rendering, and additional drivers for extended features of the hardware.
-  Device support for these drivers is very good for newer hardware, but older devices will eventually become unsupported and require the Nouveau drivers instead.
-  Performance of this driver is typically the best available and is therefore highly desirable to gamers and content creators.
-
-## Proprietary drivers
-
-Installing proprietary drivers may improve performance or certain features, however they are usually not necessary for normal daily usage. Solus provides a utility for installing drivers for detected hardware.
-
-![DoFlicky Screenshot](doflicky.jpg)
-
-If there are proprietary drivers that can be installed, they will show up in the box below the description. You can click the item you wish to install and click Install. If you are installing NVIDIA drivers, you may find it to be desirable to install the 32-bit driver as well, in the event you wish to use Steam or Wine.
-
-**Note:** A reboot will be required to use the newly installed driver.
-
-### Supported drivers
-
-| Vendor      | Drivers          |
-| ----------- | ---------------- |
-| ASUS        | piper            |
-| Broadcom    | broadcom-sta     |
-| Logitech    | piper            |
-| NVIDIA      | 470, main series |
-| Razer       | openrazer        |
-| Roccat      | piper            |
-| SteelSeries | piper            |
-| VMware      | open-vm-tools    |
-| Xbox        | xone             |
+- instructions for installing proprietary drivers and configuring specific devices.
+- lists of hardware that's compatible with Solus.

docs/user/hardware/peripherals/mice-touchpads/_category_.json

@@ -0,0 +1,6 @@
+{
+  "label": "Mice and touchpads",
+  "link": {
+    "type": "generated-index"
+  }
+}