[release-notes/gnome-3-28] general refinements

[Allan Day <allanday src gnome org>]

commit d1474d377808b4215a2af8d628ea58ff745e3261
Author: Allan Day <allanpday gmail com>
Date:   Wed Feb 28 14:28:22 2018 +0000

    general refinements

 help/C/developers.page |   24 ++++++++++++++----------
 help/C/index.page      |   37 ++++++++++++++++++++-----------------
 2 files changed, 34 insertions(+), 27 deletions(-)
---
diff --git a/help/C/developers.page b/help/C/developers.page
index 3cd9565..108beda 100644
--- a/help/C/developers.page
+++ b/help/C/developers.page
@@ -47,22 +47,26 @@
     <title>Flatpak</title>
     <media type="image" src="figures/flatpak.png"/>
     <!-- Versions since 3.26: 0.9.11, 0.9.12, 0.9.98, 0.9.98.1, 0.9.98.2, 0.9.99, 0.10, 0.8.8, 0.10.1, 
0.10.2, 0.10.2.1, 0.8.9, 0.10.3, 0.10.4, 0.11.1, 0.11.2, 0.11.3 -->
+    <p><a href="http://flatpak.org/";>Flatpak</a> is the new cross-distribution, cross-desktop technology for 
application building and distribution. While it is separate from the GNOME project, Flatpak is central to 
GNOME's developer experience plans.</p>
+    <p>Flatpak has made significant progress since the last GNOME release, with a total of 17 releases of 
its own. These have included a new 0.10.x stable series, which incorporates the enhancements in the 0.9.x 
branch. Many of the improvements have concentrated on reliability, performance and overall quality.</p>
+    <p>New features include GTK+ theme handling and language configuration support, which ensures that 
application translations are automatically installed when required.</p>
+    <p>The Flatpak command line has also received a collection of enhancements, including:</p>
+    <list>
+      <item><p>Improved tab completion.</p></item>
+      <item><p>A new <cmd>search</cmd> command, which returns matching applications from all your 
remotes.</p></item>
+      <item><p>Commands are now automatically run per-user, depending on the remote.</p></item>
+      <item><p><cmd>update</cmd> now updates flatpaks that have been installed per-user and 
system-wide</p></item>
+      <item><p><cmd>install</cmd> has a new <cmd>--reinstall</cmd> option, which removes the previously 
installed version before installing the new one - useful when installing a new version from a different 
source.</p></item>
+      <item><p>The new <cmd>remote-info</cmd> makes it possible to see information about applications that 
are in remotes.  The <cmd>--log</cmd> option shows the application history and
+can be used in combination with <cmd>flatpak update --commit</cmd> to roll back to a previous 
version.</p></item>
+    </list>
+    <p>Finally, significant progress has been made on <a href="https://flathub.org/";>Flathub</a>, Flatpak's 
new application distribution service.</p>
     <!--
 
-    * CLI improvements - better search, more flatpak info options
-    * Lots of bug fixes
-    * user is picked automatically depending on the remote
-    * update now updates both user and system
-    * new reinstall option for flatpak install
-    * new remote-info command shows information about apps in remotes
-    * new search command
     * GTK themes are automatically installed, in order to try and match the default system theme
     * New 0.10.x stable series
     * New flatpak config option, which allows setting the language
-    * Update is more reliable
     * flatpak run is faster
-    * Improved tab completion
-
     -->
 
     <p></p>
diff --git a/help/C/index.page b/help/C/index.page
index c165872..814bc7c 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -38,13 +38,14 @@
   <section id="favorites">
     <title>Choose Your Favorites</title>
     <media type="image" src="figures/placeholder.png"/>
-    <p>GNOME 3.28 makes it easier to keep track of the things that are important to you, with two new 
features. In Files, it is now possible to star files and folders. Starred items can then be easily accessed 
from the sidebar. Favorites have also been added to contacts, where they appear pinned to the top of the 
contact list.</p>
+    <p>GNOME 3.28 makes it easier to keep track of the things that are important to you, with two new 
features. In <app>Files</app>, it's now possible to star files and folders. Once they've been added, starred 
items can be easily viewed in a special location that can be opened from the sidebar.</p>
+    <p>Favorites have also been added to the <app>Contacts</app> application, where they appear pinned to 
the top of the contact list - great for contacts that you often return to.</p>
   </section>
 
   <section id="photos">
     <title>Improved Photos</title>
     <media type="image" src="figures/placeholder.png"/>
-    <p>Photos has had a number of improvements for GNOME 3.28. Most significantly, a new import from device 
feature makes it easy to add photos to your collection from removable media. Import automatically detects 
devices that contain new images. It also allows organizing new images into folders as they are imported.</p>
+    <p>Photos has had a number of major improvements for GNOME 3.28. Most significantly, a new import from 
device feature makes it easy to add photos to your collection from removable media. This feature 
automatically detects devices that contain new images and it also allows organizing new images into folders 
as they're imported.</p>
     <p>Other improvements in Photos include new editing tools for shadows and hightlights, as well as 
performance improvements.</p>
   </section>
 
@@ -57,21 +58,21 @@
 <section id="boxes">
     <title>New Boxes Features</title>
     <media type="image" src="figures/placeholder.png"/>
-    <p>Boxes, the GNOME application for using remote and virtual machines, has received a number of 
significant new features and improvements for GNOME 3.28. It's now possible to download operating systems and 
install them from the new box assistant - just pick the operating system you want to create a virtual machine 
for, and Boxes will do the rest</p>
-    <p>The new version of Boxes also makes it easy to transfer files between your computer and virtual 
machines. To transfer files, you can either drag and drop them on to the Boxes window. Alternatively, you can 
select the <gui>Send Files</gui> option and select files to be transfered from a file chooser window. In both 
cases, Boxes provides feedback about the progress of file transfers, so you know how long they are going to 
take and when they have finished.</p>
+    <p>Boxes, the GNOME application for using remote and virtual machines, has received a number of 
significant new features and improvements for GNOME 3.28. It's now possible to download operating systems and 
install them, straight from the new box assistant - just pick the operating system you want to create a 
virtual machine for, and Boxes will do the rest</p>
+    <p>The new version of Boxes also makes it easy to transfer files between your computer and virtual 
machines. To transfer files, you can either drag and drop them on to the Boxes window, or select the 
<gui>Send Files</gui> option and select files to be transfered using a file chooser window. In both cases, 
Boxes provides feedback about the progress of file transfers, so you know how long they are going to take and 
when they have finished.</p>
   </section>
 
   <section id="on-screen-keyboard">
     <title>All-New Screen Keyboard</title>
     <media type="image" src="figures/placeholder.png"/>
-    <p>GNOME's screen keyboard has been completely rewritten for 3.28. The new keyboard automatically 
activates when a text area is selected, and the view is shifted in order to ensure that the text area is 
visible while typing. A variety of layouts are supported for different locales.</p>
+    <p>GNOME's screen keyboard has been completely rewritten for 3.28, and it is far easier to use than the 
previous version. The new keyboard automatically activates when a text area is selected, and the view is 
shifted to ensure that the text area is visible while typing. A variety of layouts are supported for 
different locales.</p>
   </section>
 
   <section id="Usage">
     <title>Meet Usage</title>
     <media type="image" src="figures/placeholder.png"/>
-    <p>Usage is a new GNOME application that is being introduced in 3.28 as a technology preview, which 
allows including performance and capacity issues to be examined and diagnosed. The initial version includes 
features for examining CPU and memory consumption. Problem areas are highlighted as are applications which 
are using large amounts of resources, making it quick and easy to identify the source of issues.</p>
-    <p>The Usage preview also allows disk usage to be examined. The interface for this highlights common 
sources of disk usage that can be cleared, such as the Trash and temporary files.</p>
+    <p>Usage is a new GNOME application that is being introduced in 3.28 as a technology preview. The new 
application is designed to make it easy to diagnose and resolve performance and capacity issues. The initial 
version includes features for examining CPU and memory consumption. Problem areas are highlighted as are 
applications which are using a lot of resources, making it quick and easy to identify the source of 
issues.</p>
+    <p>The Usage preview also allows disk usage to be examined. The interface for this highlights common 
sources of disk usage that can be cleared, such as the trash and temporary files.</p>
     <p>More Usage features are planned for the future, including the ability to investigate network, power 
and data usage.</p>
   </section>
 
@@ -80,25 +81,27 @@
     <p>As usual, there are also many other smaller improvements in this GNOME
     release. Here are some of them!</p>
     <list>
-      <item><p>In <app>Clocks</app>, it is now possible to add the UTC timezone to your world 
times.</p></item>
-      <item><p>The <app>Contacts</app> application now allows sorting by either surname or first name. It 
also has a new shortcuts window and a number of minor interface improvements.</p></item>
-      <item><p>Browsing applications by category has been improved in <app>Software</app>, and it is now 
possible to sort applications by rating or by name.</p></item>
-      <item><p>The month view in <app>Calendar</app> has been improved. Events are presented in a way that's 
easier to read, and it is now possible to seamlessly expand cells which are overflowing with 
events.</p></item>
+      <item><p>In <app>Clocks</app>, it's now possible to add the UTC timezone to your world 
times.</p></item>
+      <item><p>The <app>Contacts</app> application now allows sorting by either surname or first name. It 
also has a new shortcuts window and a number of interface improvements.</p></item>
+      <item><p>The application categories in <app>Software</app> have a new look, and make it possible to 
sort applications by rating or by name.</p></item>
+      <item><p>The month view in <app>Calendar</app> has been improved. Events are presented in a way that's 
easier to read, and it's now possible to seamlessly expand cells which are overflowing with events.</p></item>
       <item><p>Weather information has been added to the <app>Calendar</app> application, so it's possible 
to see what the forecast alongside your events .</p></item>
-      <item><p>In <app>Software</app>, the <gui>Software Sources</gui> dialog has been improved and renamed 
to <gui>Software Repositories</gui>. The new version provides a more reliable and transparent view of 
software repositories that have been added. It also allows enabling, disabling and removing each 
one.</p></item>
+      <item><p>In <app>Software</app>, the <gui>Software Sources</gui> dialog has been improved and renamed 
to <gui>Software Repositories</gui>. The new version provides a more reliable and transparent view of your 
software repositories. It also allows enabling, disabling and removing each one.</p></item>
       <item><p><app>To Do</app> has an updated task view design, which makes it easy to reorder tasks with 
drag and drop. Todoist integration has also been improved.</p></item>
       <item><p><app>Fonts</app>, the GNOME font viewer, now makes it possible to see extra information about 
each font on the system, including the style, version, copyright and layout features.</p></item>
-      <item><p>Variable fonts are a new type of font that allow the weight and spacing to be set 
dynamically, rather than having predefined weights. GNOME's standard fort picker now supports these fonts and 
allowing you to set the weight and width from the dialog window.</p></item>
+      <item><p>Variable fonts are a new type of font that allow the weight to be set dynamically, rather 
than having predefined weights like bold or extra bold. GNOME's font chooser now supports these fonts and 
allows you to adjust their properties when selecting a font. The font chooser also has an improved list and 
now allows you to search for fonts by name.</p></item>
       <item><p>GNOME's collection of background wallpapers has been updated, to include a new set of 
beautiful photographs.</p></item>
-      <item><p>In <app>Maps</app>, when you click on a place, a picture is shown of it, if it's available on 
Wikipedia.</p></item>
+      <item><p>When you click on a place in <app>Maps</app> a picture of it now gets shown, if it's 
available on Wikipedia.</p></item>
       <item><p>The set of profile pictures that GNOME provides has been completely updated, with attractive 
new images to pick from either initial setup of the user account settings.</p></item>
-      <item><p>The <app>Terminal</app> has a long list of small improvements, including a redesigned 
preferences window, which combines the previously separate Preferences and Profile Preferences windows. Other 
enhancements include support for double, wavy and colored underlines, blinking text, and options for changing 
line and letter spacing.</p></item>
+      <item><p>The <app>Terminal</app> has a list of improvements, including a redesigned preferences 
window, which combines the previously separate <gui>Preferences</gui> and <gui>Profile Preferences</gui> 
windows. Other enhancements include support for double, wavy and colored underlines, blinking text, and 
options for changing line and letter spacing.</p></item>
       <item><p>Belarusian, Croatian, Greek, Lithuanian, Polish, Russian, and Ukrainian dates are now 
displayed in the correct grammatical form.</p></item>
-      <item><p><app>dconf-editor</app> has had some big changes, with a new layout for lists and search 
results and technical improvements.</p></item>
+      <item><p><app>dconf-editor</app> has had some big changes, with a new layout for lists and search 
results, as well as technical improvements under the hood.</p></item>
       <item><p>In <app>Music</app>, it's now possible to reorder playlists using drag and drop.</p></item>
       <item><p>When <app>Settings</app> is launched, it shows the last shown settings panel, which reduces 
the amount of work if you frequently change the same settings.</p></item>
       <item><p><app>Videos</app> is now able to play MJPEG files.</p></item>
-      <item><p>GNOME 3 is now able to report on the power status of connected Bluetooth Low Energy (LE) 
devices. The battery level of these devices is now shown in the <gui>Power</gui> settings, and a notification 
will warn if they are running low on power.</p></item>
+      <item><p>Feedback is now shown for the power level of connected Bluetooth Low Energy (LE) devices. The 
battery level of these devices is now shown in the <gui>Power</gui> settings, and a notification will warn if 
they are running low on power.</p></item>
+      <item><p>In <app>Games</app>, the GNOME application for retro console games, there's a new CRT video 
filter that makes game visuals look like they are being played on an old-fashioned TV. Gamepad rumble will 
now work in many cases.</p></item>
+      <item><p>Touchpads now default to use the "fingers" method for secondary click (typically right click 
on a mouse).</p></item>
     </list>
   </section>