GNOME.org
 

[release-notes] Final polish

commit ddb7a34a4dd82a6a2fcb81d120eec25cc632a3c5
Author: Allan Day <allanpday gmail com>
Date:   Thu Sep 9 16:17:38 2021 +0100

    Final polish

 help/C/developers.page | 94 +++++++++++++++++++++++++-------------------------
 help/C/index.page      | 40 ++++++++++-----------
 2 files changed, 67 insertions(+), 67 deletions(-)
---
diff --git a/help/C/developers.page b/help/C/developers.page
index 4da9b7d8..def1a0fd 100644
--- a/help/C/developers.page
+++ b/help/C/developers.page
@@ -32,27 +32,26 @@
   <title>What’s New for Developers</title>
 
   <p>Major improvements have been made to the GNOME developer experience during
-  the GNOME 41 development cycle.</p>
+  the GNOME 41 development cycle. Read on to find out more!</p>
 
   <section id="dev-docs">
     <title>Improved Documentation</title>
 
     <p>GNOME 41 is accompanied by an extravaganza of documentation
-    improvements!</p>
+    improvements! These encompass changes to the GNOME developer website, new
+    general developer documentation, improved API docs, and a new version of 
+    GNOME's design guidelines.</p>
     
     <section id="website">
       <title>New Docs Site</title>
 
-      <p>Since GNOME 40, the GNOME main developer website has been replaced,
-      with
-      <link href="https://developer.gnome.org/";>a new, streamlined portal</link>
-      that provides access to the main sources of documentation for those using
-      the GNOME platform.</p>
+      <p>Since GNOME 40, GNOME's main developer website has been replaced with
+      <link href="https://developer.gnome.org/";>a new streamlined portal</link>,
+      which provides access to all the GNOME platform docs.</p>
 
       <p>This is coupled with a <link
       href="https://developer.gnome.org/documentation/";>new developer docs site
-      </link> that contains the most up-to-date and relevant general developer
-      documentation, including:</p>
+      </link>, which contains general developer documentation, including:</p>
       
       <list>
         <item><p>A new 
@@ -63,8 +62,7 @@
         <item><p><link href="https://developer.gnome.org/documentation/guidelines.html";>Guidelines</link>
       on general topics such as programming conventions, accessibility and
       localization.</p></item>
-        <item><p>Short
-        <link href="https://developer.gnome.org/documentation/tutorials.html";>tutorials</link>
+        <item><p><link href="https://developer.gnome.org/documentation/tutorials.html";>Short tutorials</link>
         on common developer tasks, like how to use notifications, or create a
         menu in GTK.</p></item>
       </list>
@@ -80,7 +78,7 @@
       <p>The primary users of <cmd>gi-docgen</cmd> are GTK and its associated 
       libraries, whose docs can be found at
       <link href="https://docs.gtk.org";>docs.gtk.org</link>. This includes API
-      docs for:
+      docs for
       <link href="https://docs.gtk.org/gtk4/";>GTK</link>,
       <link href="https://docs.gtk.org/gdk4/";>GDK</link>,
       <link href="https://docs.gtk.org/gsk4/";>GSK</link>,
@@ -100,15 +98,14 @@
       cycle.</p>
 
       <p>The guidelines have been updated to match contemporary design
-      practice, so that they reflect up to date design conventions. They have
-      also been substantially expanded, with additional material on
-      accessibility, UI styling, adaptive UI, navigation structures, and
-      more.</p>
-
-      <p>Finally, the HIG has a new website, which is easier to navigate and 
-      search, and virtually all the old content has been rewritten, to make the
+      practice. They have also been substantially expanded, with additional
+      material on accessibility, UI styling, adaptive UI, navigation structures,
+      and more. Virtually all the old content has been rewritten, to make the
       guidance as accessible as possible.</p>
 
+      <p>Finally, the HIG has a new website, which looks better, and is easier
+      to navigate and search.</p>
+
     </section>
   
   </section>
@@ -125,16 +122,16 @@
     easier to find and access, and has a new search UI, which makes it easy to
     specify queries and browse results across a project.</p>
     
-    <p><app>Builder</app> can now build and run CMake projects, and it can also build 
-    projects that use a pure Make build setup in a Flatpak environment (thanks
-    to being able to handle <cmd>make-args</cmd> and
-    <cmd>make-install-args</cmd>).</p>
-
-    <p><app>Builder</app> has had the ability to build and deploy Flatpak bundles to 
-    connected devices for some time, which is useful when developing mobile 
-    applications. With GNOME 41, this feature has been improved, and works 
-    much more automatically. To learn how to use it, see 
+    <p><app>Builder</app>'s prexisting support for deploying to connected
+    devices has been improved for GNOME 41. This allows building and then
+    deploying Flatpak bundles to connected devices, such as mobile devices. It
+    now works much more automatically; to learn how to use it, see
     <link href="https://www.jwestman.net/2021/08/06/tutorial-mobile-dev-with-builder.html";>James Westman's 
tutorial</link>.</p>
+
+    <p>For GNOME 41, Builder can now also build and run CMake projects, and it 
+    can build projects that use a pure Make build setup in a Flatpak environment
+    (thanks to being able to handle <cmd>make-args</cmd> and
+    <cmd>make-install-args</cmd>).</p>
     
     <p>Finally, <app>Builder</app> has a new markdown renderer for GNOME 41, which produces
     much better-formatted Markdown previews.</p>
@@ -276,33 +273,36 @@
 
   <section id="gnome-os">
     <title>GNOME OS Updates</title>
-    <p>GNOME OS, the reference not-a-distribution of GNOME software, was updated
-    as well. GNOME OS builds are now tested using an openQA instance hosted at
-    <link href="https://openqa.gnome.org";>openqa.gnome.org</link>. For details
-    on how developers can use this openQA instance, see the <link
-    
href="https://gitlab.gnome.org/GNOME/gnome-build-meta/-/wikis/openqa/OpenQA-for-GNOME-developers";>developer
-    documentation</link>. Additional improvements to GNOME OS include:</p>
+    <p><link href="https://os.gnome.org/";>GNOME OS</link> provides nightly
+    development snapshots of a complete GNOME system. While it is primarily
+    used for GNOME project QA, it can also be a useful reference for downstream
+    distributions and app developers. It has received a variety of updates
+    during the GNOME 41 cycle:</p>
 
     <list>
-      <item><p>GNOME OS libraries are built with sysprof enabled, making
+      <item><p>GNOME OS libraries are now built with sysprof enabled, making
       profiling applications on GNOME OS easier.</p></item>
       <item><p><code>systemd-homed</code> is now included and can be enabled
       manually using <cmd>homectl</cmd>.</p></item>
-      <item><p>Added support for smartcards and other security keys.</p></item>
-      <item><p>Added <code>openconnect</code>, <code>fortisslvpn</code>,
-      <code>vpnc</code> and <code>openvpn</code> VPN backends to
+      <item><p>Support has been added for smartcards and other security
+      keys.</p></item>
+      <item><p>The <code>openconnect</code>, <code>fortisslvpn</code>,
+      <code>vpnc</code> and <code>openvpn</code> VPN backends have been added to
       <app>NetworkManager</app>.</p></item>
-      <item><p><app>LXC</app> tooling is included to accomodate container
-      tooling.</p></item>
-      <item><p>RISC-V was added as a CPU architecture. Details on this effort
-      can be seen in <link
-      href="https://www.youtube.com/watch?v=0preyzEb-fY";>GUADEC
-      talk</link>.</p></item>
-      <item><p>Mutter is built with <code>initrd</code> support, enabling better
+      <item><p><link href="https://linuxcontainers.org/";>LXC</link> tooling is
+      now included.</p></item>
+      <item><p>RISC-V was added as a CPU architecture.</p></item>
+      <item><p>Mutter is now built with <code>initrd</code> support, enabling better
       XWayland support.</p></item>
-      <item><p>Added <app>xdg-desktop-portal-gnome</app> for GNOME-specific
-      desktop portals.</p></item>
+      <item><p><app>xdg-desktop-portal-gnome</app> has been added, for 
+      GNOME-specific desktop portals.</p></item>
     </list>
+      
+    <p>Finally, GNOME OS builds are now tested using an openQA instance hosted
+    at <link href="https://openqa.gnome.org";>openqa.gnome.org</link>. For
+    details on how developers can use this openQA instance, see the
+    <link 
href="https://gitlab.gnome.org/GNOME/gnome-build-meta/-/wikis/openqa/OpenQA-for-GNOME-developers";>developer 
documentation</link>.</p>
+
   </section>
 
   <section id="thats-not-all">
diff --git a/help/C/index.page b/help/C/index.page
index e350f4b5..8f4907c8 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -63,12 +63,12 @@ xmlns:e="http://projectmallard.org/experimental/"; type="guide" id="index">
     consumption:</p>
 
     <list>
-      <item><p><gui>Balanced</gui>: the default profile, which provides 
+      <item><p><gui>Balanced</gui>: the default power mode, which provides
       standard performance and power consumption.</p></item>
-      <item><p><gui>Performance</gui>: increases CPU performance and power 
+      <item><p><gui>Performance</gui>: increases CPU performance and power
       consumption, allowing many applications and activities to run faster.
       </p></item>
-      <item><p><gui>Power Saver</gui>: reduces performance and power 
+      <item><p><gui>Power Saver</gui>: slower performance and lower power
       consumption.</p></item>
     </list>
     
@@ -78,13 +78,13 @@ xmlns:e="http://projectmallard.org/experimental/"; type="guide" id="index">
       mode option is not shown.</p>
     </note>
     
-    <p>With GNOME 41, the power mode feature has been improved. The mode can 
-    now be quickly changed from the <gui>System Status</gui> menu. 
+    <p>With GNOME 41, the power mode feature has been improved. Power modes can
+    now be quickly changed from the <gui>System Status</gui> menu, and
     <gui>Power Saver</gui> mode has been enhanced, so that the screen dims and 
-    fades more rapidly when it is active, and <gui>Power Saver</gui> will also
+    fades more rapidly when it is active. <gui>Power Saver</gui> will also
     automatically turn on when the battery level is low.</p>
     
-    <p>Initial support has been added to allow applications to request a
+    <p>Initial support has also been added to allow applications to request a
     particular power mode. This will be most relevant for allowing performance 
     sensitive apps, such as games, to request performance mode.</p>
   </section>
@@ -99,7 +99,7 @@ xmlns:e="http://projectmallard.org/experimental/"; type="guide" id="index">
     <list>
       <item><p>The updated explore view makes it easier to browse and discover
       apps, with descriptions of each app and more attractive tiles.</p></item>
-      <item><p>A new set of categories makes helps with browsing and exploring
+      <item><p>A new set of categories helps with browsing and exploring
       available apps.</p></item>
       <item><p>Details pages have a new design, with bigger screenshots and new 
       information tiles, which provide a better overview of each application.
@@ -108,8 +108,7 @@ xmlns:e="http://projectmallard.org/experimental/"; type="guide" id="index">
 
     <p>Almost every part of <app>Software</app> has been polished or improved in
     some way. This includes redesigned settings, more attractive layouts in the
-    installed and updates views, better OS upgrade banners, and much much
-    more.</p>
+    installed and updates views, better OS upgrade banners, and 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
@@ -153,14 +152,12 @@ xmlns:e="http://projectmallard.org/experimental/"; type="guide" id="index">
     GSM/LTE modems.</p>
  
     <p>The new <gui>Mobile</gui> settings are only shown when a a supported 
-    modem is present. It allows setting the network type, selecting whether
-    mobile data should be used, and whether data should be used while roaming,
-    as well as other more advanced settings.</p>
-
-    <p>It replaces the previous, old mobile network settings. Improvements 
-    over the old settings include the ability to handle multiple SIMs, and the
-    automatic selection of the network operator, as well as a much nicer user 
-    interface.</p>
+    modem is present. They allow setting the network type, selecting whether
+    mobile data should be used, and whether data should be used while roaming.
+    They also support using multiple SIMs and modems, and allow easy switching
+    between networks.</p>
+
+    <p>The new settings replace the previous mobile network settings.</p>
   </section>
 
   <section id="performance">
@@ -190,7 +187,7 @@ xmlns:e="http://projectmallard.org/experimental/"; type="guide" id="index">
     <title>Music</title>
     <media type="image" src="figures/music.png"/>
 
-    <p><app>Music</app> has been given a round of UI polish for GNOME 41.
+    <p><app>Music</app> has been given a round of UI updates 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. <app>Music</app> also has new welcome
@@ -205,7 +202,7 @@ xmlns:e="http://projectmallard.org/experimental/"; type="guide" id="index">
 
     <list>
       <item><p>The ability to create encrypted <sys>.zip</sys> archives in 
-      <app>Files</app>. These require a password to be opened.</p></item>
+      <app>Files</app> (these require a password to be opened).</p></item>
       <item><p>A new <app>Calendar</app> feature that allows importing events 
       from <sys>.ics</sys> files.</p></item>
       <item><p>Improved support for dark mode in <app>Web</app>, along with 
@@ -215,6 +212,9 @@ xmlns:e="http://projectmallard.org/experimental/"; type="guide" id="index">
       window will now reveal additional controls, and the window will also
       shrink down to fit on mobile displays.</p></item>
     </list>
+    
+    <p>These are just some of the many small improvements found in GNOME 41.</p>
+    
   </section>
 
   <section id="more">
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]