[release-notes/gnome-3-28] polish



commit 839b863731698e9b2cc39483b76b727a676fc9b1
Author: Allan Day <allanpday gmail com>
Date:   Wed Feb 28 17:47:36 2018 +0000

    polish

 help/C/developers.page |   30 ++++++++++--------------------
 help/C/index.page      |   34 +++++++++++++++++-----------------
 2 files changed, 27 insertions(+), 37 deletions(-)
---
diff --git a/help/C/developers.page b/help/C/developers.page
index 108beda..01866da 100644
--- a/help/C/developers.page
+++ b/help/C/developers.page
@@ -29,8 +29,8 @@
     <title>Builder</title>
     <media type="image" src="figures/placeholder.png"/>
       <p>Builder's 3.28 release includes some handy new features, important refinements, and significant 
reliability improvements.</p>
-      <p>The navigation sidebar has had a number of improvements. The file tree is not monitored in real 
time, so that changes are immediately reflected in the sidebar. It is also possible to drag and drop files in 
the sidebar, in order to move them (it's also possible to drag files on to the editor to open them). Finally, 
Git status is shown in the sidebar, so it's easy to see which files have been changed.</p>
-      <p>Builder's Flatpak support has also been improved for 3.28. Progress feedback is now shown when 
building, SDK extensions are now supported, and flatpak-builder is bundled as part of the Builder flatpak, so 
that it doesn't need to be separately installed.</p>
+      <p>The navigation sidebar has had a number of improvements. The file tree is now monitored in real 
time, so that changes are immediately reflected in the sidebar. It is also possible to drag and drop files in 
the sidebar, in order to move them (it's also possible to drag files on to the editor to open them). Finally, 
Git status is shown in the sidebar, so it's easy to see which files have been changed.</p>
+      <p>Builder's Flatpak support has also been improved for 3.28. Progress feedback is now shown when 
building, SDK extensions are now supported, and <cmd>flatpak-builder</cmd> is bundled as part of the Builder 
flatpak, so that it doesn't need to be separately installed.</p>
       <p>Assorted other improvements in this release include:</p>
       <list>
         <item><p>Progress information has been improved in the build panel. This now shows all the steps in 
the build process and which point the current build has reached.</p></item>
@@ -47,29 +47,19 @@
     <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><link href="https://flatpak.org/";>Flatpak</link> 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>
+    <p>New features include GTK+ theme handling, as well as language configuration support, which ensures 
that application translations are automatically installed when required.</p>
+    <p>The Flatpak command line interface has also had many improvements, 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>Commands are now automatically run per-user if they use a per-user remote.</p></item>
+      <item><p>The <cmd>update</cmd> command 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>
+      <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 history of the application and can be used in 
combination with <cmd>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>
-    <!--
-
-    * 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
-    * flatpak run is faster
-    -->
-
-    <p></p>
+    <p>Finally, significant progress has been made on <link href="https://flathub.org/";>Flathub</link>, 
Flatpak's new application distribution service.</p>
   </section>
 
   <section id="more">
@@ -77,7 +67,7 @@ can be used in combination with <cmd>flatpak update --commit</cmd> to roll back
     <p>Other improvements in GNOME 3.28 include:</p>
     <list>
       <item><p>GJS now has a profiler, making it possible to identify where GJS applications spend their 
execution time.</p></item>
-      <item><p><a href="https://pygobject.readthedocs.io";>PyGObject</a> is now available <a 
href="https://pypi.python.org/pypi/PyGObject";>on PyPI</a> and can be <a 
href="https://pygobject.readthedocs.io/en/latest/getting_started.html#pypi";>installed with pip</a>.</p></item>
+      <item><p><link href="https://pygobject.readthedocs.io";>PyGObject</link> is now available <link 
href="https://pypi.python.org/pypi/PyGObject";>on PyPI</link> and can be <link 
href="https://pygobject.readthedocs.io/en/latest/getting_started.html#pypi";>installed with 
pip</link>.</p></item>
       <item><p>The latest version of WebKitGTK+, 2.20, builds approximately twice as quickly as 
before.</p></item>
     </list>
   </section>
diff --git a/help/C/index.page b/help/C/index.page
index 95e1741..0cb70c8 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -33,7 +33,7 @@
   contributors.</p>
 
   <p>&gnomeversion; has been named “Chongqing” in recognition of this year’s
-  <link href="https://2017.gnome.asia/";>GNOME.Asia</link> organizing team. GNOME.Asia is GNOME's official 
annual summit in Asia, which is only possible thanks to the hard work of local volunteers. This year's event 
was in Chongqing, China, and we'd like to thank everyone who contributed to its success.</p>
+  <link href="https://2017.gnome.asia/";>GNOME.Asia</link> organizing team. GNOME.Asia is GNOME's official 
annual summit in Asia, which is only possible thanks to the hard work of local volunteers. This year's event 
was held in Chongqing, China, and we'd like to thank everyone who contributed to its success.</p>
 
   <section id="favorites">
     <title>Choose Your Favorites</title>
@@ -45,7 +45,7 @@
   <section id="personal-organization">
     <title>Personal Organization Improvements</title>
     <media type="image" src="figures/placeholder.png"/>
-    <p>GNOME's applications that help with personal organization have all had improvements for 3.28, to help 
you keep on top. These improvements include:</p>
+    <p>GNOME's applications that help with personal organization have been improved for 3.28. These 
improvements include:</p>
     <list>
       <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>
@@ -58,26 +58,26 @@
   <section id="beautiful-things">
     <title>More Beautiful Things</title>
     <media type="image" src="figures/placeholder.png"/>
-    <p>GNOME 3.28 comes with more beautiful things! First, and most significantly, GNOME's default UI font 
(called Cantarell) has undergone a significant update. Character forms and spacing have been evolved, so that 
text that is more readable and attractive. Several new weights have also been added - light and extra bold - 
which are being used to produce interfaces that are both modern and beautiful.</p>
-    <p>GNOME's collection of background wallpapers have been updated, to include a new set of beautiful 
photographs. Lastly, 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>
+    <p>GNOME 3.28 comes with more beautiful things! First, and most significantly, GNOME's default interface 
font (called Cantarell) has undergone a significant update. Character forms and spacing have been evolved, so 
that text that is more readable and attractive. Several new weights have also been added - light and extra 
bold - which are being used to produce interfaces that are both modern and beautiful.</p>
+    <p>Other beautiful things include GNOME's collection of background wallpapers, which has been updated to 
include a lovely set of photographs, and the selection of profile pictures, which has been completely updated 
with attractive new images to pick from.</p>
   </section>
 
   <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, 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>
+    <p>Boxes, the GNOME application for using remote and virtual machines, has a number of new features and 
enhancements for GNOME 3.28. One major new feature is automatic downloading of operating systems, straight 
from the new box assistant. To create a virtual machine, all you have to do is pick the operating system you 
want to use, 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. In both cases, Boxes 
provides feedback about the progress of file transfers, so you know how long they are going to take, as well 
as when they have finished.</p>
   </section>
 
   <section id="media-and-entertainment">
     <title>Media and Entertainment Features</title>
     <media type="image" src="figures/placeholder.png"/>
-    <p>Media handling and entertainment have gotten better in GNOME 3.28. Many of these changes are in 
<app>Photos</app>. This has 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. Other improvements in Photos include new editing 
tools for shadows and hightlights, as well as performance improvements.</p>
+    <p>Media handling and entertainment have gotten better in GNOME 3.28. Many of these changes are in 
<app>Photos</app>. This has a new import from device feature which makes it easy to add photos to your 
collection from removable media, such as SD cards and USB drives. This feature automatically detects devices 
that contain new images and it also allows organizing new images into folders as they're imported. Other 
improvements in Photos include new editing tools for shadows and hightlights and performance improvements.</p>
     <p>Other media and entertainment improvements include:</p>
     <list>
       <item><p><app>Videos</app> is now able to play MJPEG files.</p></item>
       <item><p>In <app>Music</app>, it's now possible to reorder playlists using drag and drop.</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><app>Games</app>, the GNOME application for retro console and arcade games, there's a new CRT 
video filter that makes game visuals look like they are being played on an old-fashioned TV. Additionally, 
gamepad rumble will now work in many cases.</p></item>
     </list>
   </section>
 
@@ -90,20 +90,19 @@
   <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. 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>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, 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>
 
-  <section id="settings-devices">
-    <title>Settings and Device Support</title>
+  <section id="device-support">
+    <title>Extended Device Support</title>
     <media type="image" src="figures/placeholder.png"/>
-    <p>The latest GNOME release comes with enhanced device support, as well as settings improvements. Most 
significantly, GNOME 3.28 comes with integrated <a 
href="https://en.wikipedia.org/wiki/Thunderbolt_(interface)#Thunderbolt_3">Thunderbolt 3</a> connection 
support. This includes security and privacy checks, designed to prevent data theft through unauthorized 
Thunderbolt 3 connections. Feedback is also shown in the top bar, to indicate when Thunderbolt 3 is active 
and when a connection is being established.</p>
-    <p>Other device and settings improvements include:</p>
+    <p>The latest GNOME release comes with extended device support. Most significantly, GNOME 3.28 comes 
with integrated <link href="https://en.wikipedia.org/wiki/Thunderbolt_(interface)#Thunderbolt_3">Thunderbolt 
3</link> connection support. This includes security checks that are designed to prevent data theft through 
unauthorized Thunderbolt 3 connections. Feedback is also shown in the top bar, to indicate when Thunderbolt 3 
is active and when a connection is being established.</p>
+    <p>Other device improvements include:</p>
     <list>
-      <item><p>All touchpads now use a gesture for secondary click (the equivalent to right click on a 
mouse) by default. The gesture is simple: keep one finger in contact with the touchpad and tap with another 
finger. The alternative behavior (tapping areas of the touchpad for primary and secondary click) can be 
restored using <app>Tweaks</app> if that is desired.</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>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>All touchpads now use a gesture for secondary click (the equivalent to right click on a 
mouse) by default. To use the gesture, keep one finger in contact with the touchpad and tap with another 
finger. In many cases this replaces tapping areas of the touchpad as the default secondary click method. A 
choice between the two behaviors is available in the <app>Tweaks</app> application.</p></item>
+      <item><p>Information is now shown about 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>
     </list>
   </section>
 
@@ -113,13 +112,14 @@
     release. Here are some of them!</p>
     <list>
       <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>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>Also 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>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 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>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 <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, as well as technical improvements under the hood.</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>
     </list>
   </section>
 


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]