Fix build/preview scripts

If we consider Fedora Workstation (Gnome) the default installation, 1Ghz, 1GB Ram, and 10GB storage is not leading to a positive experience.

antora.yml

@@ -1,5 +1,5 @@
 ---
 name: fedora
-version: rawhide
+version: f34
 # Navigation is in the main 'fedora' component:
 # https://pagure.io/fedora-docs/release-docs-home

build.sh

@@ -1,27 +1,31 @@
-#!/bin/sh
+#!/bin/bash
 
 image="docker.io/antora/antora"
 cmd="--html-url-extension-style=indexify site.yml"
 
-if [ "$(uname)" == "Darwin" ]; then
+if uname | grep -iwq darwin; then
     # Running on macOS.
     # Let's assume that the user has the Docker CE installed
     # which doesn't require a root password.
     echo ""
-    echo "This build script is using Docker container runtime to run the build in an isolated environment."
+    echo "This build script is using Docker to run the build in an isolated environment."
     echo ""
-    docker run --rm -it -v $(pwd):/antora $image $cmd
+    docker run --rm -it -v $(pwd):/antora ${image} ${cmd}
 
-elif [ "$(expr substr $(uname -s) 1 5)" == "Linux" ]; then
+elif uname | grep -iq linux; then
     # Running on Linux.
-    # Check whether podman is available, else faill back to docker
+    # Let's assume that it's running the Docker deamon
     # which requires root.
 
-    if [ -f /usr/bin/podman ]; then
+    if [ -f /usr/local/bin/antora ]; then
+        /usr/local/bin/antora ${cmd}
+    elif uname -m | grep -iwq aarch64; then
+        echo "No antora/aarch64 container try just \`npm install -g @antora/cli @antora/site-generator-default\`"
+    elif [ -f /usr/bin/podman ]; then
         echo ""
         echo "This build script is using Podman to run the build in an isolated environment."
         echo ""
-	podman run --rm -it -v $(pwd):/antora:z $image $cmd
+        podman run --rm -it -v $(pwd):/antora:z ${image} ${cmd}
 
     elif [ -f /usr/bin/docker ]; then
         echo ""
@@ -29,18 +33,19 @@ elif [ "$(expr substr $(uname -s) 1 5)" == "Linux" ]; then
         echo ""
 
         if groups | grep -wq "docker"; then
-	    docker run --rm -it -v $(pwd):/antora:z $image $cmd
-	else
+            docker run --rm -it -v $(pwd):/antora:z ${image} ${cmd}
+        else
+            echo "You might be asked for your password."
+            echo "You can avoid this by adding your user to the 'docker' group,"
+            echo "but be aware of the security implications."
+            echo "See https://docs.docker.com/install/linux/linux-postinstall/"
             echo ""
-            echo "This build script is using $runtime to run the build in an isolated environment. You might be asked for your password."
-            echo "You can avoid this by adding your user to the 'docker' group, but be aware of the security implications. See https://docs.docker.com/install/linux/linux-postinstall/."
-            echo ""
-            sudo docker run --rm -it -v $(pwd):/antora:z $image $cmd
-	fi
+            sudo docker run --rm -it -v $(pwd):/antora:z ${image} ${cmd}
+        fi
     else
         echo ""
-	echo "Error: Container runtime haven't been found on your system. Fix it by:"
-	echo "$ sudo dnf install podman"
-	exit 1
+        echo "Error: Container runtime has not been found on your system. Fix it by running this command:"
+        echo "sudo dnf install podman"
+        exit 1
     fi
 fi

modules/release-notes/nav.adoc

@@ -13,6 +13,8 @@ include::{partialsdir}/entities.adoc[]
 *** xref:sysadmin/System_Utilities.adoc[System Utilities]
 *** xref:sysadmin/Printing_Scanning.adoc[Printing and Scanning]
 ** xref:desktop/Desktop_index.adoc[Desktop Users]
+*** xref:desktop/Desktop.adoc[Desktop]
+*** xref:desktop/I18n.adoc[Internationalization]
 ** xref:developers/Developers.adoc[Developers]
 *** xref:developers/Development_Tools.adoc[Development Tools]
 *** xref:developers/Development_Binutils.adoc[Binutils]
@@ -25,5 +27,4 @@ include::{partialsdir}/entities.adoc[]
 *** xref:developers/Development_Ruby.adoc[Ruby]
 *** xref:developers/Development_Web.adoc[Web Development]
 //CHANGE THIS WITH A NEW RELEASE
-** link:https://fedoraproject.org/wiki/Common_F32_bugs[Common Bugs]
-** xref:Revision_History.adoc[Revision History]
+** link:https://fedoraproject.org/wiki/Common_F34_bugs[Common Bugs]

modules/release-notes/pages/Revision_History.adoc

@@ -1,5 +0,0 @@
-
-include::{partialsdir}/entities.adoc[]
-
-[[appe-Release_Notes-Revision_History]]
-= Revision History

modules/release-notes/pages/_partials/entities.adoc

@@ -2,7 +2,7 @@
 :BZURL: https://pagure.io/fedora-docs/release-notes/issues
 :COMMONBUGS_URL: https://fedoraproject.org/wiki/Common_F32_bugs
 :HOLDER: Fedora Project Contributors
-:PREVVER: 32
+:PREVVER: 33
 :PRODUCT: Fedora Documentation
-:PRODVER: Rawhide
-:YEAR: 2020
+:PRODVER: 34
+:YEAR: 2021

modules/release-notes/pages/desktop/Desktop.adoc

@@ -0,0 +1,85 @@
+include::{partialsdir}/entities.adoc[]
+
+[[sect-desktop]]
+= Desktop
+
+== i3 Spin
+
+Fedora Spins are versions of Fedora featuring alternative desktop environments and accompanying sets of software. Fedora 34 introduces a new Spin utilizing the i3 window manager. This is the first Fedora Spin to feature a tiling window manager instead of a traditional desktop environment.
+
+The i3 Spin provides a better installation experience for Fedora users who prefer to use i3. Prior to this Spin, end users who wished to use i3 on Fedora needed to install another Edition or Spin of Fedora, then install the i3 window manager and related packages separately, a process often requiring an external guide or tutorial.
+
+The design goals of this Spin are:
+
+* *Simple is better than complex*: the Fedora i3 Spin will choose simplicity over complexity.
+* *Fast is better than features*: the Fedora i3 Spin will choose to be fast, lean, and quick instead of full of features.
+* *There should be one - and preferably only one - obvious way to do it*: the Fedora i3 Spin will choose to maintain a single obvious way to do basic computing tasks.
+* *Now is better than never*: the Fedora i3 Spin will choose to try out and experiment with new ideas.
+
+Download and try the i3 Spin at the link:https://spins.fedoraproject.org/i3[Fedora Spins site].
+
+Learn more about the design and development of the Spin at the link:https://docs.fedoraproject.org/en-US/i3/[Fedora i3 Special Interest Group (S.I.G.) site].
+
+== A KDE Plasma image for 64-bit ARM is now available
+
+An installation image of the KDE Plasma spin is now available for the 64-bit ARM architecture (AArch64).
+
+You can download the image from the following page: link:https://alt.fedoraproject.org/alt/[].
+
+== XFCE 4.16
+
+XFCE 4.16 is available in Fedora 34.
+4.16 is the latest release of the https://www.xfce.org/[XFCE desktop environment].
+Compared to the previous 4.14 release, XFCE 4.16 brings various improvements, new features, bug fixes and a visual update.
+
+* Support for HiDPI displays has been improved with *support for fractional scaling*, accessible through the Display Settings menu.
+* The visual identity of XFCE has also been updated with a *new color palette* as well as a *redesigned icon set*.
+
+
+* *Basic system information* can now be easily obtained with a tab in the About XFCE dialog, which will show information including CPU and GPU type.
+* The file manager Thunar now includes the option to *pause and resume file operations* at will and the ability to *queue file transfers*.
+
+
+* The user experience of XFCE has been improved, with XFCE now offering *better ways to search and filter* in the Settings Manager.
+  There is a *better layout of the Power Manager* settings options.
+  The Application Finder now *searches by 'frecency'*, which combines recently and frequently opened applications.
+
+A full list of changes can be found at the https://www.xfce.org/download/changelogs/4.16[changelogs].
+
+== PipeWire is now the default audio service
+
+The *Pipewire* service now manages all audio output and input. *Pipewire* replaces the *PulseAudio* service in general use cases and the *JACK* service in professional use cases. The system now redirects audio from applications that use *PulseAudio*, *JACK*, or the *ALSA* framework into *Pipewire*.
+
+Benefits of *Pipewire* over the previous solutions include:
+
+* A unified solution for consumer and professional users
+* A flexible, modular architecture
+* High performance and low latency, similar to the *JACK* service
+* Isolation between audio clients for better security
+
+You no longer have to configure the *JACK* service for applications that use it. All *JACK* applications now work in the default Fedora configuration.
+
+== Xwayland is now distributed as a separate package
+
+The Xwayland display server was previously distributed together with the X.org server. It is now distributed separately in the `Xwayland` package.
+
+Xwayland is receiving significantly more upstream updates than X.org. The separate packaging enables Fedora to release the updated Xwayland and keep X.org at the current stable version.
+
+The updates to Xwayland include:
+
+* Multiple window buffers
+* `initfd` support
+* Xwayland `pkgconfig` file
+
+For more information about the new Xwayland features, see the Xwayland 21.1.0 announcement: link:https://lists.x.org/archives/xorg-announce/2021-March/003076.html[].
+
+== KDE Plasma now defaults to Wayland
+
+In the default configuration, the KDE Plasma desktop now runs on the Wayland display back end. The default KDE Plasma session selected in the SDDM login manager is now the Wayland session. You can still select the legacy X11 session when logging in.
+
+Starting with Fedora 34, KDE Plasma on Wayland has implemented all the necessary features that were previously missing compared to the X11 session. These features include:
+
+* Screen casting
+* Middle-click paste
+* Support for NVIDIA GPUs
+

modules/release-notes/pages/desktop/Desktop_index.adoc

@@ -1,3 +1,6 @@
 include::{partialsdir}/entities.adoc[]
 
 = Notable changes for desktop users
+
+This section lists changes in Fedora {PRODVER} relevant to desktop users.
+Use the navigation tab on the left to view release notes for various fields of interest.

modules/release-notes/pages/desktop/I18n.adoc

@@ -0,0 +1,54 @@
+include::{partialsdir}/entities.adoc[]
+
+[[sect-i18n]]
+= Internationalization
+
+== IBus 1.5.24
+* `ibus-gtk4` package is now available, which includes IBus GTK4 module to enable IBus with GTK4 applications. You may need to export `GTK_IM_MODULE=ibus`.
+* `ibus-setup` utility is enhanced to be able to search input method names in language section in "Input Method" tab for non-GNOME desktop. `gnome-control-center` is available for GNOME desktop.
+
+== ibus-anthy
+* `ibus-anthy` is now the default Japanese IME(input method engine) to develop Japanese IME more effectively as the former was `ibus-kkc`. `ibus-anthy` depends on `anthy-unicode` and `kasumi-unicode` newly instead of `anthy` and `kasumi`.
+* `kasumi-unicode` is forked from `kasumi` and the private dictionaries are moved from `$HOME/.anthy` to `$XDG_CONFIG_HOME/anthy`.
+
+
+== The Vietnamese IME now defaults to Unikey
+
+The *Unikey* input method engine (IME) is now the default IME for Vietnamese text input. It replaces the *BoGo* IME, which was the default Vietnamese IME in previous Fedora releases.
+
+Compared to *BoGo*, the new *Unikey* IME is actively maintained and better supports the Wayland display back end.
+
+The *Unikey* IME is enabled by default if you installed your system in Vietnamese. To enable *Unikey* on an existing installation:
+
+. Install the `ibus-unikey` package:
++
+----
+$ sudo dnf install ibus-unikey
+----
+. Open the *Keyboard* section in *Settings*.
+. Click the *+* button.
+. Select *Vietnamese*.
+. Select the *Vietnamese (Unikey)* IME.
+. Click *Add*.
+. Click the IME indicator on the top panel to switch the active IME.
+
+
+== The Sinhala IME now defaults to M17N
+
+The *sayura (m17n)* input method engine (IME) is now the default IME for Sinhala text input. It replaces the *Sayura* IME, which was the default Sinhala IME in previous Fedora releases.
+
+Compared to *Sayura*, the new *sayura (m17n)* IME is actively maintained and fixes several known issues.
+
+The *sayura (m17n)* IME is enabled by default if you installed your system in Sinhala. To enable *sayura (m17n)* on an existing installation:
+
+. Install the `ibus-m17n` package:
++
+----
+$ sudo dnf install ibus-m17n
+----
+. Open the *Keyboard* section in *Settings*.
+. Click the *+* button.
+. Select *Sinhala*.
+. Select the *Sinhala (sayura (m17n))* IME.
+. Click *Add*.
+. Click the IME indicator on the top panel to switch the active IME.

modules/release-notes/pages/developers/Development_Go.adoc

@@ -3,3 +3,18 @@ include::{partialsdir}/entities.adoc[]
 
 [[sect-development-go]]
 = Golang
+
+Golang 1.16, the latest stable release of the language, is available in Fedora 34.
+Compared to Golang 1.15, there are a number of changes, including, among others:
+
+* Module-aware mode is enabled by default, further consolidating Golang's move towards modules being the preferred dependency management system.
+* The `go install` command has been updated, adding the ability to build by version suffixes. It is now recommended that one use `go install` for  building and installing Golang packages when using modules.
+* Published modules can now be flagged as 'retracted' using the `retract` flag in `go.mod`. This does not remove a published version, but it will be ignored for users wanting the `latest` version of a module. Dependencies for a retracted module are preserved, but there is a warning for those who specifically wish to use the retracted package (dependencies will not break as a result of using `retract`).
+* Static files and file trees can now be part of an executable using the `embed` package.
+* The Golang runtime is improved, with memory allocation on Linux now reacting quicker to system memory demand. 
+* The `runtime/metrics` package allows for better monitoring of the Golang runtime.
+* The linker has been further improved compared to v1.15 and is significantly quicker, uses less memory, and usually creates smaller executables.
+* The `io` package has been updated, including adding of the `io/fs` package for interface with the file system, as well as deprecation of `io/ioutil`. Functionality of `io/ioutil` has been moved to other packages (`io` and `os`).
+* The `GOVCS` environment variable has been introduced to allow users to specify which version control system can be trusted and used to download source code.
+
+For further details, see the https://tip.golang.org/doc/go1.16[Golang 1.16 release notes].

modules/release-notes/pages/developers/Development_Ruby.adoc

@@ -2,3 +2,16 @@ include::{partialsdir}/entities.adoc[]
 
 [[sect-ruby]]
 = Ruby
+
+== Ruby 3.0
+
+Fedora 34 provides Ruby 3.0, the latest version of the https://www.ruby-lang.org/[Ruby language].
+Notable features of Ruby 3.0, compared to previous versions:
+
+* The ability to run concurrently is updated with regards to Ruby 2.7, with `Fiber Scheduler` and the preliminary addition of `Ractor`.
+* Static typing: `RBS` provides a foundation for allowing programs written in Ruby to define types. Ruby remains a dynamically typed language by default, but `RBS` acts as an additional (foundation) layer of a program to provide static type functionality and gain some of the benefits of a statically typed language.
+* `IRB` gains some performance advantages: it is quicker, and now one can measure the execution time using the `measure` command.
+* Standard libraries are updated.
+* Pattern matching is now a stable feature.
+
+See the https://www.ruby-lang.org/en/news/2020/12/25/ruby-3-0-0-released/[release notes] for more information.

modules/release-notes/pages/developers/Development_Tools.adoc

@@ -3,3 +3,15 @@ include::{partialsdir}/entities.adoc[]
 
 [[sect-development-tools]]
 = Development Tools
+
+== Comp-NeuroFedora container image
+
+Comp-NeuroFedora lab provides Free and Open Source Software (FOSS) to streamline computational neuroscience work.
+
+Nowadays, containers are frequently used in research work to facilitate model sharing and reproducibility. To enable users to enjoy these benefits in their research efforts, Fedora 34 introduces Comp-NeuroFedora lab in a form of _container image_. The image includes the same set of neuroscience software that the original delivery of Comp-NeuroFedora lab provides.
+
+For more information about Comp-NeuroFedora, see the [citetitle]_link:++https://docs.fedoraproject.org/en-US/neurofedora/overview/++[upstream documentation]_.
+
+For a list of Fedora labs, see the [citetitle]_link:++https://labs.fedoraproject.org/++[Functional bundles for Fedora]_ page.
+
+For more information about using containers in NeuroFedora, see the [citetitle]_link:++https://docs.fedoraproject.org/en-US/neurofedora/containers/++[Using containers]_ documentation.

modules/release-notes/pages/sysadmin/Distribution.adoc

@@ -1,5 +1,63 @@
-
 include::{partialsdir}/entities.adoc[]
 
 [[select-distribution]]
 = Distribution-wide Changes
+
+[[scale-zram-to-full-memory-size]]
+== Scale ZRAM to Full Memory Size
+
+In Fedora, a swap partition is not created by default at installation time. Instead, a zram device is created, and swap enabled on it during start-up. zram is a type of RAM drive that uses compression.
+
+For Fedora 34, the size of this zram device is increased. It is set at the same size as RAM or 8 GB, whichever is smaller. This change allows computers with smaller amounts of RAM to successfully complete installation using the Anaconda installer.
+
+Memory allocation for zram happens dynamically, so the block device's full size is not allocated as it is created. This dynamic resourse allocation, combined with compression in the zram device that is generally greater than 2:1, ensures that the swap file does not entirely consume available memory.
+
+See `man zram-generator` for more information about how zram is invoked.
+
+== New package: fbrnch
+
+A new `fbrnch` (Fed Brunch) package provides a utility which helps simplify or semi-automate workflow processes for Fedora Packagers. This package is available to users without them having to add another Copr repository.
+
+The `fbrnch` utility supports the following and more tasks:
+
+* Merging and building packages across release branches
+* Source RPM (SRPM) files, scratch builds, local install, and mock builds from arbitrary package branches
+* Cloning and listing Fedora packages from Pagure code hosting system
+* Creating, updating and listing package reviews
+* Requesting new repositories and branches, and importing new packages directly from package reviews
+
+== ARMv7 to use UEFI as default for all armhfp generated images
+
+The [citetitle]_link:++https://docs.fedoraproject.org/en-US/fedora/f30/release-notes/sysadmin/Distribution/#_uefi_for_armv7_devices++[UEFI for ARMv7 devices]_ feature delivered all the described infrastructure changes in Fedora 30. However, it brought also some problems with upstream kernel, bootloaders and a number of other pieces, which were out of Fedora control.
+
+In this release, the said problematic pieces were fixed. As a result, the user experience is consistent across all Fedora CPU architectures.
+
+== Main is a new name for default git repository branches
+
+With Fedora 34 release, data residing on the `master` branch in all Fedora git repositories have been moved to a branch named `main`. This update is in line with Fedora's vision to be free and open source software built by inclusive, welcoming, and open-minded communities.
+
+Users with existing clones of Fedora repositories need to do `git pull` to get the changed default branches. Users with existing pull requests against the `master` branch need to do `git rebase` against the `main` branch.
+
+== Compress kernel firmware to reduce size on disk
+
+Starting with Fedora 34, the kernel firmware has been compressed with the `xz -C crc32` option to reduce the ondisk size by almost a half.
+
+== Unify the location of GRUB configuration files across all supported CPU architectures
+
+This change simplifies the GRUB configuration file, improves overall user experience, and also provides the following notable benefits:
+
+* Allow the same installation to be booted with either EFI or legacy BIOS
+* Use the same documentation and commands for all architectures
+** NOTE: If grub.cfg needs updating, use `grub2-mkconfig -o /boot/grub2/grub.cfg`
+* Make GRUB configuration tools more robust by not relying on symbolic links to be created and not having to handle platform specific cases
+* Align with images generated by CoreOS Assembler (COSA) and OSBuild on how the GRUB configuration files are used
+* Align with other Linux distributions on how the GRUB configuration files are used
+
+
+== systemd-oomd prevents out-of-memory situations
+
+The `systemd-oomd` service monitors swap and CGroups on your system using the Linux pressure stall information (PSI) and analyzes wasted productivity due to resource shortages. When the system is running out of memory, `systemd-oomd` terminates processes under the CGroup that exceeds the configured memory limits.
+
+The `systemd-oomd` service is now enabled by default on new installations and when upgrading existing installations. It automatically replaces the `earlyoom` service, which previous Fedora releases used to prevent out-of-memory situations.
+
+For information on configuring `systemd-oomd`, see the `oomd.conf` man page.

modules/release-notes/pages/sysadmin/Installation.adoc

@@ -3,14 +3,219 @@ include::{partialsdir}/entities.adoc[]
 
 [[sect-installation]]
 = Installation
+:toc:
+
+[WARNING]
+====
+Fedora 34 contains two potentially breaking changes related to system installation:
+
+* Multiple Kickstart commands have been deprecated or removed. Deprecated commands in Kickstarts will cause warnings, and removed commands will cause the installation to fail. Notably, this includes the `install` command, which is used in many older Kickstart files. See xref:sysadmin/Installation.adoc#sect-kickstart-deprecated-removed[Deprecated and removed Kickstart commands and options] for a full list of deprecations and removals.
+
+* All installer boot options now must use the `inst.` prefix, which was previously optional but recommended. Anaconda boot options such as `inst.repo=` will now be ignored if they do not use this prefix.
+====
 
 [[sect-installation-anaconda]]
 == Anaconda changes
-
 This section covers changes in the [application]*Anaconda* installer, including changes in the graphical and text mode interactive installers, Kickstart, and installer boot options.
 
 [[sect-installation-anaconda-general]]
 === General changes
+* The filesystem image containing the Anaconda installer, `images/install.img`, which is present both in DVD and netinstall ISOs, no longer embeds an ext4 filesystem image.
+  Instead, files are stored directly in SquashFS, without an intermediate ext4 layer.
+  Installer content is stored more efficiently this way, resulting in savings of up to 27MiB per ISO.
+
+* The installer mounts `/tmp` of the installed system as a `tmpfs` during the installation.
+  (https://bugzilla.redhat.com/show_bug.cgi?id=1306452)
+
+* The installer installs the kbd-legacy package to support non-ascii keyboard layouts.
+  (https://bugzilla.redhat.com/show_bug.cgi?id=1919483)
+
+* Crashes in wireless networking configuration in installer GUI have been fixed.
+  (https://github.com/rhinstaller/anaconda/pull/2977)
+
+* Persistent network configuration from Kickstart configuration is now created in a later stage (not in initramfs), so all the persistent configuration files are generated using the NetworkManager API, which results in:
+** Consistency between common kickstart configuration and configuration via kickstart %pre section (the same code path is used).
+** Consistency of generated configuration files. All files are now stored in the format configured in NetworkManager. In Fedora 33 configuration files created from kickstart configuration were stored in `ifcfg` files while other configuration paths (boot options, UI) were using `keyfile` files.
+
+* Added a metapackage for image dependencies - useful when generating `boot.iso`.
+  (The plan is to eventually move stuff from lorax templates to there.)
+  (https://github.com/rhinstaller/anaconda/pull/3126)
+
+* Removed support for the `nfsiso:` pseudo-protocol.
+  Anaconda can these days detect that a `nfs:` target is an ISO file, so `nfsiso:` became redundant.
+  (https://github.com/rhinstaller/anaconda/pull/2889)
+
+=== Changes in boot options
+* The `inst.` prefix, which was previously recommended for use with Anaconda-specific boot options, is now mandatory.
+  Anaconda boot options such as `inst.stage2=` or `inst.repo=` will now be ignored if they do not use the prefix.
+  This change helps Anaconda avoid conflicts with other projects which may use the same kernel parameters.
+  You can read the discussion of this change on the link:++https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/thread/43LKTJOUO5TB7LGFWPRNXOYLEQF3KLGG/#ENTHA45Y6VO45FAD4ULPSHCTOXPML3PA++[devel mailing list].
+
+* The following boot options have been removed:
+** `inst.singlelang` - The single language mode has been removed some time ago.
+** `inst.loglevel` - Did not work.
+** `inst.zram` - Anaconda uses `zram-generator` instead.
+
+=== Changes in the graphical interface
+* Encryption of thin logical volumes is now allowed on the `Manual Partitioning` screen.
+  (https://github.com/rhinstaller/anaconda/pull/3008)
+
+* Click the `Encrypt my data` checkbox on the `Manual Partitioning` screen to automatically generate encrypted default partitioning.
+  (https://github.com/rhinstaller/anaconda/pull/3183)
+
+* The bottom banner on the `Time & Date` screen shows a correct warning about NTP servers.
+  (https://bugzilla.redhat.com/show_bug.cgi?id=1889180)
+
+* The GUI for wireless network configuration has been improved.
+  (https://github.com/rhinstaller/anaconda/pull/2977, https://github.com/rhinstaller/anaconda/pull/3009, https://github.com/rhinstaller/anaconda/pull/3098)
+
+* The caption of the `Reset All` button in custom partitioning changed to `Discard all changes`, and there is now a tooltip with detailed explanation.
+  (https://github.com/rhinstaller/anaconda/pull/2841)
+
+* Major languages are now listed first on installation the `Language selection` screen.
+  Remaining languages are listed below in alphabetical order.
+  This brings the installer experience closer to the GNOME desktop environment which already lists major languages first in its language picker.
+  The list of major languages is maintained in the `langtable` project.
+  (https://github.com/rhinstaller/anaconda/pull/2935)
+
+* Similar to the above change, major common keyboard layouts are also listed first.
+  (https://github.com/rhinstaller/anaconda/pull/2788)
+
+* Keyboard layout ordering changed to show US layout first, "native" second.
+  In locales which default keymap does not contain non-ASCII characters, it should be prepended by the US keymap.
+  For example, the default keymap settings for the Russian locale is now "us,ru" instead of "ru,us".
+  This is needed because almost everything that should be typed during installation is ASCII-only
+  (https://github.com/rhinstaller/anaconda/pull/2782)
+
+* Category titles are now translated at runtime.
+  This avoids untranslated strings showing up in categories added by Initial Setup and addons.
+  (https://github.com/rhinstaller/anaconda/pull/2907)
+
+* It is now again possible to toggle visibility of the root password and LUKS passphrase that have been typed in the installer.
+  (https://github.com/rhinstaller/anaconda/pull/3119)
+
+* Geolocation connection timeout has been lowered to 5 seconds.
+  This avoids the installer getting stuck for several minutes if the system does not have correctly configured internet connectivity.
+  (https://github.com/rhinstaller/anaconda/pull/3022)
+
+* Media verification inside the installer can now be interrupted.
+  Note that this does not apply to the pre-installer verification which is the default boot menu option (`Test this media & Install Fedora 34`).
+  (https://github.com/rhinstaller/anaconda/pull/3060)
+
+=== Changes in the text interface
+* The installer does not translate the prompt keys in the text user interface anymore.
+  (https://bugzilla.redhat.com/show_bug.cgi?id=1892830)
+
+* * Anaconda now attempts to use the best matching font for the currently selected language instead always using `eurlatgr` which does not support scripts such as Cyrillic, Arabic, or Hebrew.
+  (https://github.com/rhinstaller/anaconda/pull/3180)
+
+== Changes in Anaconda configuration files
+* A new `updates_repositories` option of the `[Payload]` section defines names of repositories that provide latest updates during the installation if the latest updates are enabled.
+  (https://github.com/rhinstaller/anaconda/pull/3023)
+
+* New `can_change_root`, `can_change_users`, and `password_policies` configuration options of the `[User Interface]` section define the default password policies.
+  (https://github.com/rhinstaller/anaconda/pull/3099)
+
+* A new `btrfs_compression` configuration option of the `[Storage]` section allows you to specify a compression algorithm and level for mounting of Btrfs file systems.
+  (https://bugzilla.redhat.com/show_bug.cgi?id=1928857)
+
+* You can now use the `kickstart_modules` option of the `[Anaconda]` section to disable the following Anaconda DBus modules: `Timezone`, `Localization`, `Security`, `Users`, `Services`.
+
+* Initial Setup now loads a product configuration file of a product found in the `os-release` files of the runtime environment.
+  (https://github.com/rhinstaller/initial-setup/pull/117)
+
+* The installer now detects the default product for product configuration files using the product from the `os-release` files of the installation environment.
+  (https://github.com/rhinstaller/anaconda/pull/3155)
+
+* You can now import RPM certificates at the end of installation.
+Specify them using `default_rpm_gpg_keys = _<list of key paths, one per line>_`.
+  (https://github.com/rhinstaller/anaconda/pull/2855)
+
+== Modularization-related changes
+* Anaconda add-ons with their own `%addon` section have to provide their own DBus module.
+  Previous support for this section has been removed.
+  For more information about add-on modularization, visit https://github.com/rhinstaller/hello-world-anaconda-addon.
+
+* The *Kdump* Anaconda add-on has been migrated to DBus.
+  (https://github.com/daveyoung/kdump-anaconda-addon/pull/29)
+
+* If an Anaconda DBus add-on fails to start, the installer now removes it from the list of available modules, and continues.
+  It no longer aborts the whole installation due to this.
+  (https://github.com/rhinstaller/anaconda/pull/2988)
+
+* Installation DBus tasks can now raise a non-critical installation error.
+  In that case, users are allowed to continue with the installation if they want to.
+  (https://github.com/rhinstaller/anaconda/pull/3147)
+
+* The Payloads module now handles RPM-OStree installation.
+  (https://github.com/rhinstaller/anaconda/pull/3234)
+
+* The Payloads module now handles the `%packages` kickstart section.
+  (https://github.com/rhinstaller/anaconda/pull/3029)
+
+* The Payloads module now handles the `module` kickstart command.
+  (https://github.com/rhinstaller/anaconda/pull/3233)
+
+== Changes in updates images
+* The installer no longer supports updates images with files in the `/run/install/updates` and `/tmp/updates` directories.
+  Use real paths to update the installation environment.
+  (https://github.com/rhinstaller/anaconda/pull/3127)
+
+* The initial setup can now be tested with an updates image. Call `./scripts/makeupdates` to create the updates image from the local repository.
+  Call `/usr/libexec/anaconda/apply-updates` to download and extract the updates image in the runtime environment. (https://github.com/rhinstaller/initial-setup/pull/116)
+
+* The installer no longer supports updates images on floppy disks.
+  (https://github.com/rhinstaller/anaconda/pull/3033)
 
 [[sect-installation-kickstart]]
-=== Kickstart changes
+== Kickstart changes
+* The `%anaconda` Kickstart section and its `pwpolicy` Kickstart command are deprecated and will be removed in in the future. Use Anaconda configuration files to set up the password policy.
+  (https://github.com/rhinstaller/anaconda/pull/3099)
+
+* The `interactive-defaults.ks` file is deprecated and will be removed in in the future. Use Anaconda configuration files instead.
+  (https://github.com/rhinstaller/anaconda/pull/3099)
+
+* The installer does not fail anymore if a device is defined in a kickstart file with `noauto` in `--fsoptions`.
+  (https://bugzilla.redhat.com/show_bug.cgi?id=1824357)
+
+* Kickstart parsing warnings are now always shown.
+  Might need a switch to `tty1` though.
+  (https://github.com/rhinstaller/anaconda/pull/3080)
+
+* Invalid host name in kickstart now causes a warning and halt instead of just crashing.
+  (https://github.com/rhinstaller/anaconda/pull/3135)
+
+* (Py)kickstart options now consistently list version where they are removed, both in code and generated docs.
+  Previously this information was not reliably present, and had to be inferred from comparisons of version-specific handlers.
+  (https://github.com/pykickstart/pykickstart/pull/365, https://github.com/pykickstart/pykickstart/pull/369)
+
+* (Py)kickstart documentation now provides details on (py)kickstart-specific terminology around command and option lifecycle - deprecations and removals.
+  This is highly useful, because the (py)kickstart ideas differ significantly from the common understanding of these terms.
+  (https://github.com/pykickstart/pykickstart/pull/356)
+
+[[sect-kickstart-deprecated-removed]]
+=== Deprecated and removed Kickstart commands and options
+This version brings a big cleanup of unused, deprecated, and removed commands and options. Deprecated commands and options no longer do anything and log a warning, and removed commands and options cause errors and break the installation.
+
+* Removed commands:
+** `autostep`
+** `device`
+** `deviceprobe`
+** `dmraid`
+** `install`
+** `method`
+** `multipath`
+
+* Removed options:
+** `bootloader --upgrade`
+** `harddrive --biospart`
+** `ignoredisk --interactive`
+** `partition --active`
+
+* Removed the `%traceback` section - use `%onerror` instead.
+
+* Deprecated options:
+** `timezone --ntpservers`, `--nontp`
+** `logging --level`
+** `%packages --excludeWeakdeps` (use `--exclude-weakdeps` instead), `--InstLangs` (use `--inst-langs` instead)
+** `repo --ignoregroups`, `--sslcacert`, `--sslclientcert`, `--sslclientkey`

modules/release-notes/pages/sysadmin/Security.adoc

@@ -1,5 +1,24 @@
-
 include::{partialsdir}/entities.adoc[]
 
 [[sect-security]]
 = Security
+
+== Align the SELinux policy with the current kernel
+
+In Fedora 34 release, the SELinux policy has been updated to match the state in the current kernel so that SELinux can utilize the kernel provided features.
+
+The enhancements to the SELinux policy include new:
+
+* classes: `lockdown`, `perf_event`
+* permissions: `watch`, `watch_mount`, `watch_reads`, `watch_sb`, `watch_with_perm`
+* capabilities: `bpf`, `checkpoint_restore`, `perfmon`
+
+This update brings better granularity for granting permissions, which has subsequent security benefits.
+
+== Support for disabling SELinux through `/etc/selinux/config` has been removed
+
+With this release, support for disabling SELinux through the `SELINUX=disabled` option in the `/etc/selinux/config` file has been removed from the kernel. Furthermore, the Anaconda installation program and the corresponding man pages have been updated to reflect this change. This change also enables read-only-after-initialization protection for the Linux Security Module (LSM) hooks.
+
+If your scenario requires to disable SELinux, add the `selinux=0` parameter to your kernel command line.
+
+See the link:https://docs.fedoraproject.org/en-US/quick-docs/changing-selinux-states-and-modes/[Changing SELinux states and modes] section in Fedora Quick Docs and the link:https://fedoraproject.org/wiki/Changes/Remove_Support_For_SELinux_Runtime_Disable[] for more information.

modules/release-notes/pages/sysadmin/Storage.adoc

@@ -3,3 +3,53 @@ include::{partialsdir}/entities.adoc[]
 
 [[sect-storage]]
 = Storage
+
+== The root Btrfs file system now uses compression
+
+New Fedora installations now enable transparent compression on the root Btrfs file system, including all its subvolumes. The default compression algorithm is `zstd:1`. This change has no effect on Fedora variants that do not use Btrfs in their installation.
+
+The benefits of the compression include:
+
+* The compression saves storage space and can significantly increase the lifespan of flash-based media, such as SSDs, by reducing write amplification.
+* The compression can increase read and write performance.
+
+You can configure the Btrfs compression on an existing installation:
+
+* To enable the compression:
+.. Edit the `/etc/fstab` file.
+.. Add the `compress=zstd:1` option to the `/` mount point.
+.. Remount the file system:
++
+----
+$ sudo mount -o remount,compress=zstd:1 /
+----
+
+* To disable the compression:
+.. Edit the `/etc/fstab` file.
+.. Remove the `compress=zstd:1` option from the `/` mount point.
+.. Remount the file system:
++
+----
+$ sudo mount -o remount,compress=none /
+----
+
+For more information about the Btrfs compression, see link:https://fedoraproject.org/wiki/Changes/BtrfsTransparentCompression[].
+
+
+== stratis-cli and stratisd rebased to version 2.3.0
+
+The `stratis-cli` and `stratisd` packages have been upgraded to version 2.3.0, which provides multiple bug fixes and enhancements. Notable changes include:
+
+* The `stratis pool bind <select_encryption_policy>` command has been added. This command adds encryption policy to all devices in the specified pool. This establishes an alternative mechanism for unlocking a pool.
+* The `stratis pool unbind <select_encryption_policy>` command has been added.
+* The functionality of the `stratis pool unlock <select_encryption_policy>` command has been extended. It is now necessary to specify the encryption mechanism - either the kernel keyring, the tang server, or the Trusted Platform Module (TPM) 2 device.
+* Stratis filesystem symlinks are now in the `/dev/stratis/` directory. You need to update your system configurations that make use of the older filesystem paths.
+* Users are able to specify their preferred log level.
+* The `org.storage.stratis2.Manager.r3` D-Bus interface has been updated to enable the `UnlockPool` method to take an additional parameter `unlock_method`.
+* The `org.storage.stratis2.pool.r3` D-Bus interface adds two new methods: `Bind` and `Unbind`.
+
+Two new dependencies have been added for `clevis` and `clevis-luks` packages.
+
+For more information, see the stratis(8) manual page.
+
+For full information about this release, see the [citetitle]_link:++https://stratis-storage.github.io/stratis-release-notes-2-3-0/++[upstream release notes]_.

modules/release-notes/pages/sysadmin/System_Utilities.adoc

@@ -2,3 +2,49 @@ include::{partialsdir}/entities.adoc[]
 
 [[sect-system-utilities]]
 = System Utilities
+
+== NTPsec
+
+`ntpsec` replaces `ntp` in Fedora 34.
+`ntpsec` is designed with the highest security standards in mind and its focus is to be a more secure implementation of `ntp`.
+This change improves the overall security of Fedora, as `ntp` contained a number of vulnerabilities that had been exploited in recent years and were not fixed, nor were fixes considered likely to come soon.
+`ntpsec` is an open-source, actively maintained, fork of `ntp` and improves on it by removing obsolete code, updating the codebase, and adding additional features.
+
+There are not likely to be any visible effects for Fedora users: `ntpsec` is already almost fully compatible with `ntp` and so existing settings should continue to function for most users.
+There are very minor functional changes between `ntpsec` and `ntp`, as described https://docs.ntpsec.org/latest/ntpsec.html[here], and so there is the potential for limited problems to occur.
+If problems do occur, then check system logs from the `ntpd` service and modify `/etc/ntpd/conf` as necessary, see the https://docs.ntpsec.org/latest/[documentation for NTPsec].
+
+The latest version, v1.20, is available in Fedora 34.
+See the https://gitlab.com/NTPsec/ntpsec/-/blob/master/NEWS.adoc[NTPsec project news page] for information about the latest version compared to prior releases.
+
+== MariaDB 10.5
+
+Fedora 34 provides the `mariadb` package version 10.5, replacing the 10.4 series in Fedora since Fedora 32.
+
+MariaDB 10.5 introduces several enhancements to improve functionality, compatibility and performance.
+
+Highlights
+
+* Executables with "mysql*" names changed to "mariadb-*" names. The original names are now symlinks to the new names. link:https://mariadb.com/kb/en/changes-improvements-in-mariadb-105/#binaries-named-mariadb-mysql-symlinked[More information]
+* New storage engine available: link:https://mariadb.com/kb/en/using-the-s3-storage-engine/[Amazon S3]
+* New INET6 data type for storing IPv6 addresses.
+* Priviledges are now more granular.
+
+For full information about this release, see the link:https://mariadb.com/kb/en/changes-improvements-in-mariadb-105/[official MariaDB release notes].
+
+== Move deprecated bluez utilities to sub-package
+
+Certain number of utilities in the upstream `bluez` bluetooth package have long been deprecated and no longer receive any updates. The functionality of those utilities was replaced by the core `bluetoothctl` utility.
+
+In Fedora 34, the deprecated `bluez` utilities have been moved to a dedicated sub-package to indicate their upstream support status.
+
+The list of utilities being moved are:
+
+* `ciptool`
+* `gatttool`
+* `hciattach`
+* `hciconfig`
+* `hcidump`
+* `hcitool`
+* `rfcomm`
+* `sdptool`

modules/release-notes/pages/welcome/Hardware_Overview.adoc

@@ -10,11 +10,11 @@ Fedora {PRODVER} provides software to suit a wide variety of applications. The s
 
 The figures below are a recommended minimum for the default installation. Your requirements may differ, and most applications will benefit from more than the minimum resources.
 
-* 1GHz or faster processor
+* 2GHz dual core processor or faster
 
 * 2GB System Memory
 
-* 10GB unallocated drive space
+* 15GB unallocated drive space
 
 Users of system equipped with the minimum memory of 1GB may want to consider Fedora Spins with less resource intense Desktop Environments 
 
@@ -29,7 +29,7 @@ For best results on systems with less than 1GB of memory, use the DVD installati
 
 The figures below are recommended for the default x86_64 Workstation installation featuring the Gnome desktop . Your requirements may differ, depending on Desktop Environment and use case.
 
-* 2GHz dual core processor 
+* 2GHz quad core processor 
 
 * 4GB System Memory
 

preview.sh

@@ -1,13 +1,13 @@
 #!/bin/sh
 
-if [ "$(uname)" == "Darwin" ]; then
+if [ "$(uname)" = "Darwin" ]; then
     # Running on macOS.
     # Let's assume that the user has the Docker CE installed
     # which doesn't require a root password.
     echo "The preview will be available at http://localhost:8080/"
     docker run --rm -v $(pwd):/antora:ro -v $(pwd)/nginx.conf:/etc/nginx/conf.d/default.conf:ro -p 8080:80 nginx
 
-elif [ "$(expr substr $(uname -s) 1 5)" == "Linux" ]; then
+elif [ "$(expr substr "$(uname -s)" 1 5)" = "Linux" ]; then
     # Running on Linux.
     # Fedora Workstation has python3 installed as a default, so using that
     echo ""

site.yml

@@ -1,12 +1,12 @@
 site:
   title: Local Preview
-  start_page: fedora:release-notes:index
+  start_page: fedora:release-notes:index.adoc
 content:
   sources:
    - url: .
      branches: HEAD
    - url: https://pagure.io/fedora-docs/release-docs-home.git
-     branches: f32
+     branches: f34
 ui:
   bundle:
     url: https://asamalik.fedorapeople.org/ui-bundle.zip
@@ -18,5 +18,5 @@ output:
   destinations:
   - provider: archive
 runtime:
-  pull: true
+  fetch: true
   cache_dir: ./cache