From c4424e6fe4bc1d9e54ef65e52f6915b92dce50c6 Mon Sep 17 00:00:00 2001
From: Simon Clark <simon.richard.clark@gmail.com>
Date: Nov 01 2017 20:34:06 +0000
Subject: Add #20 #21 #23 'Modular Server Release' - updated


---

diff --git a/_topic_map.yml b/_topic_map.yml
index 992406a..1f72bc7 100644
--- a/_topic_map.yml
+++ b/_topic_map.yml
@@ -40,29 +40,31 @@ Topics:
   - Name: Changes in Fedora for System Administrators
     Dir: sysadmin
     Topics:
-      - Name: Fedora Modularity
-        File: Modularity
-      - Name: Kernel
-        File: Kernel
+#     - Name: Fedora Modularity
+#       File: Modularity
+#     - Name: Kernel
+#       File: Kernel
       - Name: Installation
         File: Installation
       - Name: Security
         File: Security
-      - Name: Mail Servers
-        File: Mail_Servers
+#     - Name: Mail Servers
+#       File: Mail_Servers
       - Name: Domain Controllers
         File: Domain_Controllers
-      - Name: X.Org
-        File: Xorg
+      - Name: ARM Architectures
+        File: ARM_Architectures
+#     - Name: X.Org
+#       File: Xorg
   - Name: Changes in Fedora for Desktop Users
     Dir: desktop
     Topics:
       - Name: Desktop
         File: Desktop
-      - Name: Networking
-        File: Networking
-      - Name: Internationalization
-        File: I18n
+#     - Name: Networking
+#       File: Networking
+#     - Name: Internationalization
+#       File: I18n
   - Name: Changes in Fedora for Developers
     Dir: developers
     Topics:
@@ -70,14 +72,14 @@ Topics:
         File: Development_Tools
       - Name: C and C++
         File: Development_C
-      - Name: Containers
-        File: Containers
-      - Name: D
-        File: Development_D
+#     - Name: Containers
+#       File: Containers
+#     - Name: D
+#       File: Development_D
       - Name: Go
         File: Development_Go
-      - Name: Haskell
-        File: Development_Haskell
+#     - Name: Haskell
+#       File: Development_Haskell
       - Name: Java
         File: Development_Java
       - Name: Perl
@@ -88,5 +90,5 @@ Topics:
         File: Development_Ruby
       - Name: Web Development
         File: Development_Web
-  - Name: Revision History
-    File: Revision_History
+# - Name: Revision History
+#   File: Revision_History
diff --git a/en-US/Revision_History.adoc b/en-US/Revision_History.adoc
index 14c7208..03ebe9a 100644
--- a/en-US/Revision_History.adoc
+++ b/en-US/Revision_History.adoc
@@ -1,8 +1,6 @@
-
-include::en-US/entities.adoc[]
-
 [[appe-Release_Notes-Revision_History]]
-== Revision History
+= Revision History
+include::en-US/entities.adoc[]
 
 `26.01-3`:: Sun Jul 30 2017, (docs AT lists.fedoraproject.org), First AsciiDoc version.
 
diff --git a/en-US/desktop/Desktop.adoc b/en-US/desktop/Desktop.adoc
index 8a36c2a..b62157c 100644
--- a/en-US/desktop/Desktop.adoc
+++ b/en-US/desktop/Desktop.adoc
@@ -1,9 +1,7 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-desktop]]
-== Desktop
+= Desktop
+include::en-US/entities.adoc[]
 
 [[sect-desktop-dnfdragora]]
-=== dnfdragora replaces Yumex-DNF
+== dnfdragora replaces Yumex-DNF
 Previous releases of Fedora have included https://github.com/timlau/yumex-dnf/blob/develop/README.md[Yumex-DNF] as a graphical user interface for package management.  Yumex-DNF is no longer under active development and so it has been replaced in Fedora 27 by https://github.com/manatools/dnfdragora[dnfdragora]. dnfdragora is a new DNF frontend that is written in Python 3 and uses https://github.com/libyui/libyui[libYui], the widget abstraction library written by SUSE, so that it can be run using Qt 5, GTK+ 3, or ncurses interfaces.
diff --git a/en-US/desktop/I18n.adoc b/en-US/desktop/I18n.adoc
index 82ba61e..025c43c 100644
--- a/en-US/desktop/I18n.adoc
+++ b/en-US/desktop/I18n.adoc
@@ -1,5 +1,3 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-i18n]]
-== Internationalization
+= Internationalization
+include::en-US/entities.adoc[]
diff --git a/en-US/desktop/Networking.adoc b/en-US/desktop/Networking.adoc
index f92d5b8..cae7975 100644
--- a/en-US/desktop/Networking.adoc
+++ b/en-US/desktop/Networking.adoc
@@ -1,5 +1,3 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-networking]]
-== Networking
+= Networking
+include::en-US/entities.adoc[]
diff --git a/en-US/developers/Containers.adoc b/en-US/developers/Containers.adoc
index 7a863d3..36c5c50 100644
--- a/en-US/developers/Containers.adoc
+++ b/en-US/developers/Containers.adoc
@@ -1,5 +1,4 @@
 
-include::en-US/entities.adoc[]
-
 [[sect-containers]]
-== Containers
+= Containers
+include::en-US/entities.adoc[]
diff --git a/en-US/developers/Development_C.adoc b/en-US/developers/Development_C.adoc
index 06f1b01..a63f5eb 100644
--- a/en-US/developers/Development_C.adoc
+++ b/en-US/developers/Development_C.adoc
@@ -1,16 +1,14 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-c]]
-== C and C++
+= C and C++
+include::en-US/entities.adoc[]
 
 [[sect-boost]]
-=== Boost 1.64
+== Boost 1.64
 The http://www.boost.org[Boost C++ libraries] have been upgraded to version 1.64. Apart from a number of bugfixes and improvements to existing libraries, this brings a new library compared to Fedora 26, Boost.Process.
 For more information, see the http://www.boost.org/users/history/version_1_64_0.html[Boost 1.64 release notes].
 
 [[sect-c-glibc]]
-=== GNU C Library 2.26
+== GNU C Library 2.26
 Fedora 27 ships with version 2.26 of the GNU C Library (glibc). New features include:
 
 * A per-thread malloc cache has been added that significantly improves the malloc API family of functions on certain multithreaded workloads.
diff --git a/en-US/developers/Development_D.adoc b/en-US/developers/Development_D.adoc
index 65202a6..f79a418 100644
--- a/en-US/developers/Development_D.adoc
+++ b/en-US/developers/Development_D.adoc
@@ -1,5 +1,3 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-d]]
-== D
+= D
+include::en-US/entities.adoc[]
diff --git a/en-US/developers/Development_Go.adoc b/en-US/developers/Development_Go.adoc
index 82c9761..8787ab9 100644
--- a/en-US/developers/Development_Go.adoc
+++ b/en-US/developers/Development_Go.adoc
@@ -1,12 +1,10 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-development-go]]
-== Go
+= Go
+include::en-US/entities.adoc[]
 
 
 [#go-upgraded-to-1.9]
-=== Golang 1.9
+== Golang 1.9
 
 Fedora 27 brings Golang 1.9, which includes performance improvements, bug fixes, and new features. Most notably, support for type aliasing, parallel compilation, and direct bit manipulation has been added. For a complete list of changes, see upstream change notes at link:https://tip.golang.org/doc/go1.9[https://tip.golang.org/doc/go1.9].
 
diff --git a/en-US/developers/Development_Haskell.adoc b/en-US/developers/Development_Haskell.adoc
index ff42c73..7aee91c 100644
--- a/en-US/developers/Development_Haskell.adoc
+++ b/en-US/developers/Development_Haskell.adoc
@@ -1,5 +1,3 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-haskell]]
-== Haskell
+= Haskell
+include::en-US/entities.adoc[]
diff --git a/en-US/developers/Development_Java.adoc b/en-US/developers/Development_Java.adoc
index d54a9a8..f2d1465 100644
--- a/en-US/developers/Development_Java.adoc
+++ b/en-US/developers/Development_Java.adoc
@@ -1,10 +1,9 @@
-include::en-US/entities.adoc[]
-
 [[sect-java]]
-== Java
+= Java
+include::en-US/entities.adoc[]
 
 [[sect-java-java9]]
-=== Java 9 Technology Preview
+== Java 9 Technology Preview
 Fedora 27 includes a technology preview of Java 9, offered through the `java-9-openjdk` and `java-9-openjdk-devel` and new `java-9-openjdk-jmod` packages.
 
 Java 8 remains the default JDK for this release. The inclusion of Java 9 / OpenJDK 9 will allow developers to develop and test their applications for the next version of Java in parallel while everyone can continue using the stable Java 8 for daily use.
@@ -12,7 +11,7 @@ Java 8 remains the default JDK for this release. The inclusion of Java 9 / OpenJ
 More information about the new features of OpenJDK 9 is available from http://openjdk.java.net/projects/jdk9/[the OpenJDK website].
 
 [[sect-java-decouple]]
-=== System Java Setting Decoupled from Java Command Setting
+== System Java Setting Decoupled from Java Command Setting
 In earlier versions of Fedora, Java applications installed from RPMs were run in the JVM that was found using the `PATH` environment variable. From this release, Java applications will be run using the default system JVM, which will be OpenJDK 8 in Fedora 27, without refering to `PATH`. Users will still be able to override the default by using the `JAVA_HOME` environment variable.
 
 More detail about this revised configuration can be found on the https://fedoraproject.org/wiki/Changes/Decouple_system_java_setting_from_java_command_setting[change page].
diff --git a/en-US/developers/Development_Perl.adoc b/en-US/developers/Development_Perl.adoc
index 4cde6c6..538e068 100644
--- a/en-US/developers/Development_Perl.adoc
+++ b/en-US/developers/Development_Perl.adoc
@@ -1,15 +1,13 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-perl]]
-== Perl
+= Perl
+include::en-US/entities.adoc[]
 
 [[sect-perl-core]]
-=== Packaging of the Perl Core Modules
+== Packaging of the Perl Core Modules
 The release of Fedora 27 brings a change in the way that the Perl core modules are packaged by Fedora. In Perl, the core modules are the standard set of modules that ship with the Perl interpreter.  Previously in Fedora, the Perl core modules were split into a number of subpackages in such a way that installing the `perl` package did not install the full set of Perl core modules.  This behaviour was not what was expected by most Perl users and so, from Fedora 27, installing the `perl` package now installs the full set of Perl core modules. It is still possible to install only a minimal Perl interpreter by installing just the `perl-interpreter` package.
 
 [[sect-perl-526]]
-=== Perl 5.26
+== Perl 5.26
 A new version of perl is released every year and version 5.26 is 2017's stable release. This release includes three updates with widespread effects:
 
 ."." no longer in @INC
diff --git a/en-US/developers/Development_Python.adoc b/en-US/developers/Development_Python.adoc
index aa6cb15..3ca9748 100644
--- a/en-US/developers/Development_Python.adoc
+++ b/en-US/developers/Development_Python.adoc
@@ -1,9 +1,7 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-python]]
-== Python
+= Python
+include::en-US/entities.adoc[]
 
 [[sect-python-sudo-pip]]
-=== Making sudo pip Safe (Again)
+== Making sudo pip Safe (Again)
 The location where sudo pip3 installs modules has been changed to /usr/local/lib/pythonX.Y/site-packages, and sudo pip3 is henceforth safer to use. No other changes in user experience are expected. Sudo pip3 is not considered a standard way to install Python packages. Virtual environment and pip3 install --user should still be the prefered options. Additionally, Fedora will increase it's compliance with the Filesystem Hierarchy Standard, as user-installed host-specific Python modules will now be correctly located under /usr/local.
diff --git a/en-US/developers/Development_Ruby.adoc b/en-US/developers/Development_Ruby.adoc
index b58cce4..ac63427 100644
--- a/en-US/developers/Development_Ruby.adoc
+++ b/en-US/developers/Development_Ruby.adoc
@@ -1,11 +1,9 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-ruby]]
-== Ruby
+= Ruby
+include::en-US/entities.adoc[]
 
 [[sect-ruby-rails]]
-=== Ruby on Rails 5.1
+== Ruby on Rails 5.1
 Ruby on Rails has been updated to version 5.1 in Fedora 27.  Some of the highlights in Rails 5.1 include:
 
 * Drop jQuery as a default dependency
diff --git a/en-US/developers/Development_Tools.adoc b/en-US/developers/Development_Tools.adoc
index 6378a97..ec933c9 100644
--- a/en-US/developers/Development_Tools.adoc
+++ b/en-US/developers/Development_Tools.adoc
@@ -1,15 +1,13 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-development-tools]]
-== Development Tools
+= Development Tools
+include::en-US/entities.adoc[]
 
 [[sect-development-tools-debuginfo]]
-=== Debuginfo Package Improvements
+== Debuginfo Package Improvements
 To observe what a program is doing, Fedora provides additional meta-data about code that is installed and runs on your system. These can be used together with tracers, profilers and debuggers to better understand what is running on your system (or to understand crashes or failures better). Previously, these debug info meta-data packages were fairly large, containing lots of information about multiple sub-packages together. With Fedora 27, these debug info meta-data packages have been split up into smaller sub-packages, making it possible to install just the debuginfo for one specific sub-package or library. The source files needed for debuggers (but not necessarily for tracers and profilers) have been separated out into their own debugsource package and it is now possible to install multiple, different versions or architectures of the debug info packages at the same time. For example, when trying to introspect a program installed in a container or virtual machine that is a different version of the package installed on the host, or when both a 32 bit and 64 bit version of a library is available.
 
 [[sect-development-tools-bodhi]]
-=== Bodhi Now Handles Non-RPM Artifacts
+== Bodhi Now Handles Non-RPM Artifacts
 Bodhi, the https://bodhi.fedoraproject.org/[Fedora Updates System], can now handle more than just RPM files. If it can be tagged in https://koji.fedoraproject.org/koji/[Koji], it should be accepted by Bodhi. The release of Bodhi 3.0.0 enables:
 
 * Support for updating non-RPM artifacts, like modules.
diff --git a/en-US/developers/Development_Web.adoc b/en-US/developers/Development_Web.adoc
index 924f16e..a128680 100644
--- a/en-US/developers/Development_Web.adoc
+++ b/en-US/developers/Development_Web.adoc
@@ -1,11 +1,9 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-web-development]]
-== Web Development
+= Web Development
+include::en-US/entities.adoc[]
 
 [[sect-web-development-node]]
-=== Node.js 8
+== Node.js 8
 Fedora 27 includes Node.js 8, which is the current version of the platform. This release line will become a Node.js Long Term Support (LTS) release at the end of October 2017.  Some of the highlights of Node.js 8 include:
 
 * http2 support
diff --git a/en-US/index.adoc b/en-US/index.adoc
index 1a4b1ee..40bc738 100644
--- a/en-US/index.adoc
+++ b/en-US/index.adoc
@@ -1,8 +1,6 @@
-
+= Release Notes
 include::en-US/entities.adoc[]
 
-== Release Notes
-
 Release Notes for Fedora {PRODVER}
 
 [abstract]
diff --git a/en-US/sysadmin/ARM_Architectures.adoc b/en-US/sysadmin/ARM_Architectures.adoc
new file mode 100644
index 0000000..3d1ce33
--- /dev/null
+++ b/en-US/sysadmin/ARM_Architectures.adoc
@@ -0,0 +1,9 @@
+[[sect-ARM]]
+= ARM Architectures
+include::en-US/entities.adoc[]
+
+[[sect-ARM-aarch64]]
+== aarch64 Single Board Computer Disk Images
+Fedora now includes disk images for 64 bit ARM (aarch64) Single Board Computer (SBC) devices, for example the Pine64 or Raspberry Pi 3. In the same manner as for the ARMv7 SBC images, there will be a single disk image for each of Fedora's Minimal, Server and Workstation Editions that will cover all supported devices.
+
+More information about Fedora on ARM and the supported devices can be found on the https://fedoraproject.org/wiki/Architectures/ARM[ARM Architecture page].
diff --git a/en-US/sysadmin/Domain_Controllers.adoc b/en-US/sysadmin/Domain_Controllers.adoc
index 0743a0b..85f8080 100644
--- a/en-US/sysadmin/Domain_Controllers.adoc
+++ b/en-US/sysadmin/Domain_Controllers.adoc
@@ -1,11 +1,9 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-domain-controllers]]
-== Domain Controllers
+= Domain Controllers
+include::en-US/entities.adoc[]
 
 [[sect-domain-controllers-samba-changes]]
-=== Samba changes
+== Samba changes
 
 Samba project completed conversion of Samba AD DC to support MIT Kerberos. Fedora 27 is the first Fedora version to include Samba AD domain controller functionality.
 
@@ -34,7 +32,7 @@ Samba AD DC with MIT Kerberos does not have all the features of Heimdal Kerberos
 
 
 [[sect-domain-controllers-freeipa-changes]]
-=== FreeIPA changes
+== FreeIPA changes
 
 FreeIPA has been upgraded to version 4.6. This is a major FreeIPA release which supports Python 3.
 
diff --git a/en-US/sysadmin/Installation.adoc b/en-US/sysadmin/Installation.adoc
index 0aed75f..05d2144 100644
--- a/en-US/sysadmin/Installation.adoc
+++ b/en-US/sysadmin/Installation.adoc
@@ -1,9 +1,7 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-installation]]
-== Installation
+= Installation
+include::en-US/entities.adoc[]
 
 [[sect-installation-trim]]
-=== TRIM pass down to encrypted disks
+== TRIM pass down to encrypted disks
 With this change Fedora becomes more friendly to SSD drives. During the installation procedure, any newly created storage with LUKS encryption (newly formatted encrypted partitions, logical volumes, and so on) is configured to use the `discard` option which enables https://en.wikipedia.org/wiki/Trim_(computing)[TRIM]. This potentially increases the lifetime of SSD drives while **not** affecting encrypted data security and it has no effect on HDDs.
diff --git a/en-US/sysadmin/Kernel.adoc b/en-US/sysadmin/Kernel.adoc
index 68403b4..c586f75 100644
--- a/en-US/sysadmin/Kernel.adoc
+++ b/en-US/sysadmin/Kernel.adoc
@@ -1,5 +1,3 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-kernel]]
-== Kernel
+= Kernel
+include::en-US/entities.adoc[]
diff --git a/en-US/sysadmin/Mail_Servers.adoc b/en-US/sysadmin/Mail_Servers.adoc
index 69da345..ff03dc1 100644
--- a/en-US/sysadmin/Mail_Servers.adoc
+++ b/en-US/sysadmin/Mail_Servers.adoc
@@ -1,5 +1,3 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-mail-servers]]
-== Mail Servers
+= Mail Servers
+include::en-US/entities.adoc[]
diff --git a/en-US/sysadmin/Modularity.adoc b/en-US/sysadmin/Modularity.adoc
index dffe075..c310466 100644
--- a/en-US/sysadmin/Modularity.adoc
+++ b/en-US/sysadmin/Modularity.adoc
@@ -1,6 +1,3 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-modularity]]
 == Fedora Modularity
 Modularity is the initiative to disconnect the lifecycle of applications from each other and from the lifecycle of the operating system, while still maintaining the ease of use of a typical Linux distribution. This work has produced two changes that have been incorporated into Fedora 27: Host and Platform and Modular Server.
diff --git a/en-US/sysadmin/Security.adoc b/en-US/sysadmin/Security.adoc
index dcdaf11..9c055be 100644
--- a/en-US/sysadmin/Security.adoc
+++ b/en-US/sysadmin/Security.adoc
@@ -1,11 +1,9 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-security]]
-== Security
+= Security
+include::en-US/entities.adoc[]
 
 [[sect-security-kerberos-kcm]]
-=== Kerberos KCM credential cache by default
+== Kerberos KCM credential cache by default
 Fedora 27 defaults to a new Kerberos credential cache type called Kerberos Cache Manager (KCM), implemented in the sssd-kcm service, that is better suited for containerized environments and also provides a better user experience in the general case. Key features of KCM include:
 
 * Kerberos credential caches are handled by a userspace deamon with a UNIX socket entry point. That means the UIDs and GIDs of the cache owners are subject to UID namespacing, which is beneficial in containerized environments.
@@ -15,12 +13,12 @@ Fedora 27 defaults to a new Kerberos credential cache type called Kerberos Cache
 Information about using KCM can be found in `man sssd-kcm` and also in `man sssd-secrets`, because KCM uses sssd-secrets for data storage.  Additional information is contained in the https://docs.pagure.org/SSSD.sssd/design_pages/kcm.html[SSSD Design Page for KCM].
 
 [[sect-security-krb5-appl]]
-=== krb5-appl Packages Removed
+== krb5-appl Packages Removed
 The `krb5-appl-clients` and `krb5-appl-servers` packages are considered to be obsolete and have been removed from Fedora. These packages provided Kerberos-aware telnet, ftp, rcp, rsh, and rlogin clients and servers. Users should to move to more modern security tools, such as openssh.
 
 
 [#sect-defauilt-ciopher-in-openvpn-changed-to-256-bit-aes-gcm]
-=== Default cipher in OpenVPN changed to 256-bit AES-GCM
+== Default cipher in OpenVPN changed to 256-bit AES-GCM
 
 OpenVPN configurations utilizing the newer `openvpn-server@.service` unit file now use a stronger cipher for the VPN tunnel by default. The default is changed from the Blowfish algorithm using 128-bit keys to the newer AES-GCM algorithm with 256-bit keys.
 
@@ -30,7 +28,7 @@ To facilitate an easy migration path away from Blowfish for clients not supporti
 
 
 [#sect-openshh-server-now-follows-system-wide-crypto-policies]
-=== OpenSSH Server now follows system-wide crypto policies
+== OpenSSH Server now follows system-wide crypto policies
 
 Fedora defines system-wide crypto policies, which are followed by cryptographic libraries and tools, including OpenSSH clients. This allows administrators to use different system-wide security levels. With this update, OpenSSH Server adheres to these system-wide crypto policies, too.
 
@@ -38,12 +36,12 @@ This modification is implemented using a script, which places configuration gene
 
 
 [#sect-ssh-1-support-removed-from-openssh]
-=== SSH-1 support removed from OpenSSH
+== SSH-1 support removed from OpenSSH
 
 The SSH-1 protocol is obsolete and no longer considered secure. As such, it is not supported by the default OpenSSH client binaries packaged for Fedora. This changes removes support for the SHH-1 protocol altogether by removing the *openssh-clients-ssh1* subpackage.
 
 
 [#sect-libcurl-switches-to-using-openssl]
-=== libcurl switches to using OpenSSL
+== libcurl switches to using OpenSSL
 
 The *libcurl* library now uses OpenSSL for TLS and crypto (instead of NSS). TLS certificates and keys stored in the NSS database need to be exported to files for *libcurl* to be able to load them. See link:http://pki.fedoraproject.org/wiki/NSS_Database[http://pki.fedoraproject.org/wiki/NSS_Database] for instructions on how to work with the NSS database.
diff --git a/en-US/sysadmin/Xorg.adoc b/en-US/sysadmin/Xorg.adoc
index aec9aa0..297f213 100644
--- a/en-US/sysadmin/Xorg.adoc
+++ b/en-US/sysadmin/Xorg.adoc
@@ -1,5 +1,3 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-x-org]]
-== X.Org
+= X.Org
+include::en-US/entities.adoc[]
diff --git a/en-US/welcome/Feedback.adoc b/en-US/welcome/Feedback.adoc
index 61d0c0e..e96e078 100644
--- a/en-US/welcome/Feedback.adoc
+++ b/en-US/welcome/Feedback.adoc
@@ -1,16 +1,14 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-Release_Notes-Feedback]]
-== Feedback
+= Feedback
+include::en-US/entities.adoc[]
 
 Thank you for taking the time to provide your comments, suggestions, and bug reports to the Fedora community; this helps improve the state of Fedora, Linux, and free software worldwide.
 
-=== Providing Feedback on Fedora Software
+== Providing Feedback on Fedora Software
 
 To provide feedback on Fedora software or other system elements, please refer to link:++http://fedoraproject.org/wiki/BugsAndFeatureRequests++[Bugs And Feature Requests]. A list of commonly reported bugs and known issues for this release is available from link:{COMMONBUGS_URL}[Common F26 Bugs] on the wiki.
 
-=== Providing Feedback on Release Notes
+== Providing Feedback on Release Notes
 
 If you feel these release notes could be improved in any way, you can provide your feedback directly to the beat writers. There are several ways to provide feedback, in order of preference:
 
diff --git a/en-US/welcome/Hardware_Overview.adoc b/en-US/welcome/Hardware_Overview.adoc
index 0473cf6..fe8b852 100644
--- a/en-US/welcome/Hardware_Overview.adoc
+++ b/en-US/welcome/Hardware_Overview.adoc
@@ -1,13 +1,11 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-hardware-overview]]
-== Hardware Overview
+= Hardware Overview
+include::en-US/entities.adoc[]
 
 Fedora {PRODVER} provides software to suit a wide variety of applications. The storage, memory and processing requirements vary depending on usage. For example, a high traffic database server requires much more memory and storage than a business desktop, which in turn has higher requirements than a single-purpose virtual machine.
 
 [[hardware_overview-specs]]
-=== Minimum System Configuration
+== Minimum System Configuration
 
 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.
 
@@ -19,28 +17,28 @@ The figures below are a recommended minimum for the default installation. Your r
 
 .Low memory installations
 [NOTE]
-===
+====
 Fedora {PRODVER} can be installed and used on systems with limited resources for some applications. Text, VNC, or kickstart installations are advised over graphical installation for systems with very low memory. Larger package sets require more memory during installation, so users with less than 768MB of system memory may have better results preforming a minimal install and adding to it afterward.
 
 For best results on systems with less than 1GB of memory, use the DVD installation image.
-===
+====
 
 [[hardware_overview-resolution]]
-=== Display resolution
+== Display resolution
 
 .Graphical Installation requires 800x600 resolution or higher
 [NOTE]
-===
+====
 Graphical installation of Fedora requires a minimum screen resolution of 800x600. Owners of devices with lower resolution, such as some netbooks, should use text or VNC installation.
 
 Once installed, Fedora will support these lower resolution devices. The minimum resolution requirement applies only to graphical installation.
-===
+====
 
 [[hardware_overview-graphics]]
-=== Graphics Hardware
+== Graphics Hardware
 
 [[hardware_overview-graphics-legacy_gpus]]
-==== Minimum Hardware for Accelerated Desktops
+=== Minimum Hardware for Accelerated Desktops
 
 Fedora {PRODVER} supports most display adapters. Modern, feature-rich desktop environments like *GNOME3* and *KDE Plasma Workspaces* use video devices to provide 3D-accelerated desktops. Older graphics hardware may *not support* acceleration:
 
@@ -51,12 +49,12 @@ Fedora {PRODVER} supports most display adapters. Modern, feature-rich desktop en
 * Radeon prior to R300 (Radeon 9500)
 
 [[hardware_overview-graphics-cpu_acceleration]]
-==== CPU Accelerated Graphics
+=== CPU Accelerated Graphics
 
 Systems with older or no graphics acceleration devices can have accelerated desktop environments using *LLVMpipe* technology, which uses the CPU to render graphics. *LLVMpipe* requires a processor with `SSE2` extensions. The extensions supported by your processor are listed in the `flags:` section of `/proc/cpuinfo`
 
 [[hardware_overview-graphics-desktops]]
-==== Choosing a Desktop Environment for your hardware
+=== Choosing a Desktop Environment for your hardware
 
 Fedora {PRODVER}'s default desktop environment, *GNOME3*, functions best with hardware acceleration. Alternative desktops are recommended for users with older graphics hardware or those seeing insufficient performance with *LLVMpipe*.
 
diff --git a/en-US/welcome/Overview.adoc b/en-US/welcome/Overview.adoc
index e35d924..0e8a1c4 100644
--- a/en-US/welcome/Overview.adoc
+++ b/en-US/welcome/Overview.adoc
@@ -1,8 +1,6 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-overview]]
-== Overview
+= Overview
+include::en-US/entities.adoc[]
 
 As always, Fedora continues to develop and integrate the latest free and open source software. The following sections provide a brief overview of major changes from the last release of Fedora.
 
diff --git a/en-US/welcome/Welcome.adoc b/en-US/welcome/Welcome.adoc
index 52f2df0..42d1df2 100644
--- a/en-US/welcome/Welcome.adoc
+++ b/en-US/welcome/Welcome.adoc
@@ -1,8 +1,6 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-welcome_to_fedora]]
-== Welcome to Fedora
+= Welcome to Fedora
+include::en-US/entities.adoc[]
 
 The Fedora Project is a partnership of Free software community members from around the globe. The Fedora Project builds open source software communities and produces a Linux distribution called Fedora.
 
@@ -25,7 +23,7 @@ To find out more general information about Fedora, refer to the following pages,
 * link:++http://fedoraproject.org/wiki/Join++[Participate in the Fedora Project]
 
 [[sect-need-help]]
-=== Need Help?
+== Need Help?
 
 There are a number of places you can get assistance should you run into problems.
 
@@ -34,6 +32,6 @@ If you run into a problem and would like some assistance, go to link:++http://as
 You may also find assistance on the `#fedora` channel on the IRC net `irc.freenode.net`. Keep in mind that the channel is populated by volunteers wanting to help, but folks knowledgeable about a specific topic might not always be available.
 
 [[sect-providing-help]]
-=== Want to Contribute?
+== Want to Contribute?
 
 You can help the Fedora Project community continue to improve Fedora if you file bug reports and enhancement requests. Refer to link:++http://fedoraproject.org/wiki/BugsAndFeatureRequests++[Bugs And Feature Requests] on the Fedora Wiki for more information about bug and feature reporting. Thank you for your participation.

