From 80acf90e5cd195efbb3484a04fad51c5f3dc7933 Mon Sep 17 00:00:00 2001 From: Allan Day Date: Nov 24 2022 12:32:39 +0000 Subject: User docs polish --- diff --git a/user-docs/modules/ROOT/pages/disk-config.adoc b/user-docs/modules/ROOT/pages/disk-config.adoc index 06e4117..9c68a06 100644 --- a/user-docs/modules/ROOT/pages/disk-config.adoc +++ b/user-docs/modules/ROOT/pages/disk-config.adoc @@ -2,11 +2,11 @@ Fedora Workstation uses a different default disk configuration from other Fedora Editions and Spins. This page describes that configuration along with the motivations behind it. -Other, non-default, disk configuration options are available to be used with Workstation, and can be selected during the disk partitioning step in the installer. +Other, non-default, disk configuration options are available to be used with Workstation, and can be configured during the disk partitioning step in the installer. == Btrfs -Btrfs is the default filesystem used by Fedora Workstation. Btrfs has two key advantages for all users using the default filesystem configuration: +Btrfs is the default filesystem used by Fedora Workstation. Btrfs has two key advantages for users using the default filesystem configuration: 1. Transparent compression means that data stored on disk uses less space 2. System reinstallation while preserving user data can be supported, while avoiding the issue of volumes running out of space. This is due to the fact that Btrfs subvolumes are limited to a static predefined size. diff --git a/user-docs/modules/ROOT/pages/index.adoc b/user-docs/modules/ROOT/pages/index.adoc index 74f7f0f..8620f5f 100644 --- a/user-docs/modules/ROOT/pages/index.adoc +++ b/user-docs/modules/ROOT/pages/index.adoc @@ -1,24 +1,24 @@ = Fedora Workstation Documentation -These pages are a general guide to Fedora Workstation. They provide an overview of Workstation, and are intended for Workstation users and Fedora contributors alike. They should be useful for those who want to know how to use Workstation and how it is put together, from a technical perspective. +These pages are a general guide to Fedora Workstation. They provide an overview of Workstation, and are intended for Workstation users and Fedora contributors. They should be useful for those who want to know how to use Workstation, as well as those who want to know how it is put together. == User Help The content in these pages is technical in nature. If you don't want to know about the technical aspects of Workstation, our https://getfedora.org/en/workstation/[web page] provides an introduction to what you can expect from Fedora Workstation as a user. -Advice on how to use the Workstation desktop can be found in the built-in *Help* app, which can be launched from the desktop. This user help can also be https://help.gnome.org/users/gnome-help/stable/[browsed online], and includes an overview of the desktop, as well as detailed help on using the apps and system settings. +Information on how to use the Workstation desktop can be found in the https://help.gnome.org/users/gnome-help/stable/[GNOME user help]. This includes an overview of the desktop, as well as docs on using the apps and system settings. == Overview Fedora Workstation is Fedora's official desktop edition. It provides a powerful, easy to use desktop experience. Workstation is intended to be a great general purpose desktop. It also aims to be a fantastic platform for software developers. -Workstation is part of the Fedora project. As such, it shares components, tools and processes with other Fedora Editions and Spins. However, Workstation is also an independent project, which is able to make its own design decisions, and is a distinct product of its own. +Workstation is part of the Fedora project. As such, it shares components, tools, and processes with other Fedora Editions and Spins. However, Workstation is also an independent project, which is able to make its own design and technical decisions, and is a distinct product of its own. -The https://docs.fedoraproject.org/en-US/workstation-working-group/[Workstation Working Group] is the main team that has responsibility for Fedora Workstation. However, Workstation wouldn't be possible without the hard work of teams and individuals across the entire Fedora community. +The https://docs.fedoraproject.org/en-US/workstation-working-group/[Workstation Working Group] is the team that has responsibility for Fedora Workstation. However, Workstation wouldn't be possible without the hard work of teams and individuals across the entire Fedora community. == System Requirements -Hardware with a 40GB SSD disk and 4GB RAM is recommended for Fedora Workstation. It is possible to use hardware with lower specifications. However, the resulting experience may be suboptimal. +To have a good experience, hardware with a 40GB SSD disk and 4GB RAM is recommended for Fedora Workstation. However, it is possible to use hardware with lower specifications. Workstation images are available for x86_64 and aarch64 architectures, providing support for Intel, AMD and ARM processors. diff --git a/user-docs/modules/ROOT/pages/software-repos.adoc b/user-docs/modules/ROOT/pages/software-repos.adoc index 0af5eac..7a8ecd0 100644 --- a/user-docs/modules/ROOT/pages/software-repos.adoc +++ b/user-docs/modules/ROOT/pages/software-repos.adoc @@ -44,4 +44,4 @@ Fedora Workstation works to ensure that the open source Nouveau driver provides === h264 Codecs -Due to patent issues, Fedora cannot directly provide the h264 multimedia codec. However, it is automatically installed for users, from a non-Fedora source. \ No newline at end of file +Due to patent issues, Fedora cannot distribute the h264 multimedia codec itself. However, Workstation does automatically install this codec for users, from a non-Fedora source. \ No newline at end of file