[release-notes] format notes in Mallard

[Link Dupont <link src gnome org>]

commit ca741de5bf3b3deb133a16f36d1371ed8a86b788
Author: Link Dupont <link sub-pop net>
Date:   Tue Aug 31 11:14:16 2021 -0400

    format notes  in Mallard

 help/C/index.page | 220 +++++++++++++++++++++++++++++++++++++-----------------
 1 file changed, 153 insertions(+), 67 deletions(-)
---
diff --git a/help/C/index.page b/help/C/index.page
index c863946e..faa878a9 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -23,84 +23,170 @@ xmlns:e="http://projectmallard.org/experimental/"; type="guide" id="index">
 
   <title>Introducing GNOME &gnomeversion;</title>
 
-GNOME 41 is the product of 6 months' work by the GNOME project. It includes a number of significant 
improvements and new features, as well as a large collection of smaller enhancements.
-
-The most notable changes this release include the revamped Software app, new multitasking settings, and 
enhanced power management features. With these changes, GNOME is smarter, more flexible, and offers a richer 
and more engaging experience than ever before.
-
-GNOME 41 also comes with significant improvements for developers, including a new developer documentation 
website, a major new version of the Human Interface Guidelines, new features in the Builder IDE, GTK 4 
enhancements, and much more.
-
-GNOME 41 is the second release to use GNOME's new version numbering schema, which has replaced the old 
odd/even point release approach with a simpler, single integer. The next release, version 42, is planned for 
March 2022.
-
-## What's new for users
-
-### Overhauled Software install experience
-
-GNOME's Software app has been given an overhaul for GNOME 41. It's now easier to browse available apps, 
thanks to the inclusion of descriptions in app tiles, as well as a new, smaller set of application 
categories. Application pages also have a new design, with bigger screenshots and new information tiles with 
information about each app.
-
-Almost every part of the application has been polished or improved in some way. This includes redesigned 
settings, more attractive layouts in the installed and updates view, enhanced OS upgrade banners, and much 
much more.
-
-The changes aren't skin deep, either: there have been many fixes and improvements under the hood, to make 
the experience faster and more reliable. 
-
-### New multitasking settings
-
-GNOME 41 includes a new Multitasking settings panel, which includes common settings related to window 
switching, workspaces and displays. The settings make it possible to:
-
- - disable the activities hot corner
- - disable "active screen edges" (resizing a window by dragging it against the screen edge)
- - switch from a dynamic to a static number of workspaces
- - include workspaces on all displays and not just the primary display
- - when switching between apps using Super+Tab, only switch between apps on the current workspace
-
-These settings make it possible to adjust GNOME to your preferred way of working, as well as to particular 
hardware setups.
-
-### Enhanced power management features
-
-Power profiles were originally introduced in GNOME last release, version 40. They provide three modes which 
can be used to control device performance and power consumption:
-
- - Balanced, which is the default mode. This provides a standard performance and power consumption.
- - Performance, in which CPU performance is increased, so that many apps and activities will run faster, 
with greater power consumption.
- - Power saver, which both makes the device run a little slower, and saves power.
-
-From GNOME 40 it has been possible to switch between these power profiles from the power settings.
-
-With GNOME 41, power modes have been improved. It is now possible to view and change the power mode from the 
system status menu in the top bar. Low power mode has also been enhanced: when it is active, the screen will 
now dim after short periods of inactivity and, when the screen fades prior to suspend, it does so more 
quickly.
-
-Power saver mode is now also automatically enabled when running on low battery (this behavior can be 
controlled from the power settings).
-
-Initial support has been added to allow apps to request a power profile. This is most relevant for allowing 
performance sensitive apps to request performance mode, to ensure fast operation.
-
-
-### New Connections app
-
-Connections is GNOME's new remote desktop client. It provides a modern, easy to use experience for 
connecting to other desktops, and automatically handles as much of the complexity for you as possible. VNC 
and RDP connections are both supported.
+  <p>GNOME &gnomeversion; is the product of 6 months' work by the GNOME project.
+  It includes a number of significant improvements and new features, as well as a
+  large collection of smaller enhancements.</p>
+
+  <p>The most notable changes this release include the revamped Software app, new
+  multitasking settings, and enhanced power management features. With these
+  changes, GNOME is smarter, more flexible, and offers a richer and more engaging
+  experience than ever before.</p>
+
+  <p>GNOME &gnomeversion; also comes with significant improvements for developers,
+  including a new developer documentation website, a major new version of the
+  Human Interface Guidelines, new features in the Builder IDE, GTK 4 enhancements,
+  and much more.</p>
+
+  <p>GNOME &gnomeversion; is the second release to use GNOME's new version
+  numbering schema, which has replaced the old odd/even point release approach
+  with a simpler, single integer. The next release, version 42, is planned for
+  March 2022.</p>
+
+  <section id="software">
+    <title>Overhauled Software install experience</title>
+
+    <p>GNOME's Software app has been given an overhaul for GNOME 41. It's now
+    easier to browse available apps, thanks to the inclusion of descriptions in
+    app tiles, as well as a new, smaller set of application categories.
+    Application pages also have a new design, with bigger screenshots and new
+    information tiles with information about each app.</p>
+
+    <p>Almost every part of the application has been polished or improved in some
+    way. This includes redesigned settings, more attractive layouts in the
+    installed and updates view, enhanced OS upgrade banners, and much much
+    more.</p>
+
+    <p>The changes aren't skin deep, either: there have been many fixes and
+    improvements under the hood, to make the experience faster and more
+    reliable.</p>
+  </section>
 
-### New Cellular settings panel
+  <section id="multitasking">
+    <title>New multitasking settings</title>
+
+    <p>GNOME &gnomeversion; includes a new Multitasking settings panel, which
+    includes common settings related to window switching, workspaces and displays.
+    The settings make it possible to:</p>
+
+    <list>
+      <item><p>disable the activities hot corner</p></item>
+      <item><p>disable "active screen edges" (resizing a window by dragging it
+      against the screen edge)</p></item>
+      <item><p>switch from a dynamic to a static number of workspaces</p></item>
+      <item><p>include workspaces on all displays and not just the primary
+      display</p></item>
+      <item><p>when switching between apps using
+      <keyseq><key>Super</key><key>Tab</key></keyseq>, only switch between apps on
+      the current workspace</p></item>
+    </list>
+
+    <p>These settings make it possible to adjust GNOME to your preferred way of
+    working, as well as to particular hardware setups.</p>
+  </section>
 
-TODO.
+  <section id="power-profiles">
+    <title>Enhanced power management features</title>
+
+    <p>Power profiles were originally introduced in GNOME last release, version
+    40. They provide three modes which can be used to control device performance
+    and power consumption:</p>
+
+    <list>
+      <item><p><gui>Balanced</gui>, which is the default mode. This provides a
+      standard performance and power consumption.</p></item>
+      <item><p><gui>Performance</gui>, in which CPU performance is increased, so
+      that many apps and activities will run faster, with greater power
+      consumption.</p></item>
+      <item><p><gui>Power saver</gui>, which both makes the device run a little
+      slower, and saves power.</p></item>
+    </list>
+
+    <p>From GNOME 40 it has been possible to switch between these power profiles
+    from the power settings.</p>
+
+    <p>With GNOME 41, power modes have been improved. It is now possible to view
+    and change the power mode from the system status menu in the top bar. Low
+    power mode has also been enhanced: when it is active, the screen will now dim
+    after short periods of inactivity and, when the screen fades prior to suspend,
+    it does so more quickly.</p>
+
+    <p>Power saver mode is now also automatically enabled when running on low
+    battery (this behavior can be controlled from the power settings).</p>
+
+    <p>Initial support has been added to allow apps to request a power profile.
+    This is most relevant for allowing performance sensitive apps to request
+    performance mode, to ensure fast operation.</p>
+  </section>
 
-### Smoother, faster
+  <section id="connections-app">
+    <title>New Connections app</title>
 
-GNOME is continually working to improve performance, responsiveness and smoothness, and GNOME 41 includes a 
collection of improvements in this area.
+    <p><app>Connections</app> is GNOME's new remote desktop client. It provides a
+    modern, easy to use experience for connecting to other desktops, and
+    automatically handles as much of the complexity for you as possible. VNC and
+    RDP connections are both supported.</p>
+  </section>
 
- - Efficiency improvements in GNOME 41 mean that the screen will update faster in response to keyboard and 
pointer input. This change only applies to those using the Wayland display server, and the effects will be 
more noticeable with some displays rather than others (the improvement is more significant on displays with 
lower refresh rates).
- - System-level multitouch gestures now behave more reliably and consistenty.
- - The transition when switching between workspaces is now more seamless, thanks to ensuring that there is a 
focused window on the workspaces that are being moved between.
- - Rendering has been improved GTK 4, with better performance as well as bug fixes.
- - Finally, a major code cleanup has happened in Mutter, GNOME's window manager, which will improve 
long-term maintainability and efficiency.
+  <section id="cellular-preferences">
+    <title>New Cellular settings panel</title>
 
-### A prettier Music app
+    <p>TODO.</p>
+  </section>
 
-GNOME's Music app has had a round of UI polish for GNOME 41. Artwork is now larger and has rounded corners, 
the artist list includes images, a new album view includes a handy play button, and the redesigned player bar 
is more spacious.
+  <section id="performance">
+    <title>Smoother, faster</title>
+
+    <p>GNOME is continually working to improve performance, responsiveness and
+    smoothness, and GNOME &gnomeversion; includes a collection of improvements in
+    this area.</p>
+
+    <list>
+      <item><p>Efficiency improvements in GNOME &gnomeversion; mean that the
+      screen will update faster in response to keyboard and pointer input. This
+      change only applies to those using the Wayland display server, and the
+      effects will be more noticeable with some displays rather than others (the
+      improvement is more significant on displays with lower refresh
+      rates).</p></item>
+      <item><p>System-level multitouch gestures now behave more reliably and
+      consistenty.</p></item>
+      <item><p>The transition when switching between workspaces is now more
+      seamless, thanks to ensuring that there is a focused window on the
+      workspaces that are being moved between.</p></item>
+      <item><p>Rendering has been improved GTK 4, with better performance as well
+      as bug fixes.</p></item>
+      <item><p>Finally, a major code cleanup has happened in Mutter, GNOME's
+      window manager, which will improve long-term maintainability and
+      efficiency.</p></item>
+    </list>
+  </section>
 
-Music also has new welcome artwork.
+  <section id="music">
+    <title>A prettier Music app</title>
 
-### That's not all
+    <p>GNOME's Music app has had a round of UI polish for GNOME 41. Artwork is now
+    larger and has rounded corners, the artist list includes images, a new album
+    view includes a handy play button, and the redesigned player bar is more
+    spacious.</p>
 
-GNOME 41 also includes lots of other, smaller improvements, including:
+    <p>Music also has new welcome artwork.</p>
+  </section>
 
- - Files now allows creating encrypted .zip files, which require a password to be opened.
- - Calendar can now import events from .ics files.
- - Web has better support for dark mode, faster pinch to zoom (on some websites), and has better handling 
for unresponsive websites.
+  <section id="thats-not-all">
+    <title>That's not all</title>
+
+    <p>GNOME &gnomeversion; also includes lots of other, smaller improvements,
+    including:</p>
+
+    <list>
+      <item><p><app>Files</app> now allows creating encrypted .zip files, which
+      require a password to be opened.</p></item>
+      <item><p><app>Calendar</app> can now import events from .ics
+      files.</p></item>
+      <item><p><app>Web</app> has better support for dark mode, faster pinch to
+      zoom (on some websites), and has better handling for unresponsive
+      websites.</p></item>
+    </list>
+  </section>
 
   <section id="getting-gnome">
     <title>Getting GNOME &gnomeversion;</title>