[gnome-user-docs/wip/mdh: 6/6] gnome-help: update look and display pages (fixes #149)




commit fa40f3778c143f44d68e1377ec93b0a5abb67912
Author: Michael Hill <mdhillca gmail com>
Date:   Wed Mar 2 16:49:53 2022 -0500

    gnome-help: update look and display pages (fixes #149)

 gnome-help/C/display-dual-monitors.page | 17 ++++++------
 gnome-help/C/display-night-light.page   |  7 ++---
 gnome-help/C/look-background.page       | 49 +++++++++++++++++++++++++--------
 gnome-help/C/look-display-fuzzy.page    | 12 +++-----
 gnome-help/C/look-resolution.page       |  8 ++----
 gnome-help/C/media.page                 |  4 +--
 gnome-help/C/power-whydim.page          |  8 ++----
 gnome-help/C/prefs-display.page         |  9 +++++-
 gnome-help/C/session-screenlocks.page   |  8 ++----
 9 files changed, 68 insertions(+), 54 deletions(-)
---
diff --git a/gnome-help/C/display-dual-monitors.page b/gnome-help/C/display-dual-monitors.page
index e2f1236d..6f74da61 100644
--- a/gnome-help/C/display-dual-monitors.page
+++ b/gnome-help/C/display-dual-monitors.page
@@ -6,10 +6,8 @@
   <info>
     <link type="guide" xref="prefs-display"/>
 
-    <revision pkgversion="3.8.0" version="0.3" date="2013-03-09" status="outdated"/>
-    <revision pkgversion="3.9.92" date="2013-09-23" status="review"/>
-    <revision pkgversion="3.28" date="2018-07-28" status="review"/>
     <revision pkgversion="3.34" date="2019-11-12" status="review"/>
+    <revision version="gnome:42" status="final" date="2022-02-27"/>
 
     <credit type="author">
       <name>Tiffany Antopolski</name>
@@ -111,7 +109,8 @@
       </note>
     </item>
     <item>
-      <p>Select the orientation, resolution or scale, and refresh rate.</p>
+      <p>Click on each monitor in the list and select the orientation,
+      resolution or scale, and refresh rate.</p>
     </item>
     <item>
       <p>Click <gui>Apply</gui>. The new settings will be applied for 20
@@ -132,12 +131,12 @@
       pass from one display to another.</p></item>
       <item><p><gui>Mirror:</gui> the same content is shown on two displays,
       with the same resolution and orientation for both.</p></item>
-      <item><p><gui>Single Display:</gui> only one display is configured,
-      effectively turning off the other one. For instance, an external monitor
-      connected to a docked laptop with the lid closed would be the single
-      configured display.</p></item>
     </list>
-
+    <p>When only one display is needed, for example, an external monitor
+    connected to a docked laptop with the lid closed, the other monitor can be
+    switched off. In the list, click on the monitor you want to disable, and
+    turn the switch to off.</p>
+      
 </section>
 
 <section id="multiple">
diff --git a/gnome-help/C/display-night-light.page b/gnome-help/C/display-night-light.page
index a0a0db53..991df087 100644
--- a/gnome-help/C/display-night-light.page
+++ b/gnome-help/C/display-night-light.page
@@ -4,11 +4,8 @@
   <info>
     <link type="guide" xref="prefs-display"/>
 
-    <revision pkgversion="3.28" date="2018-07-28" status="review"/>
-    <revision pkgversion="3.33.3" date="2019-07-21" status="review"/>
-    <revision pkgversion="3.34" date="2019-11-11" status="review"/>
-    <revision pkgversion="3.38.2" date="2021-03-06" status="review"/>
     <revision pkgversion="40.1" date="2021-06-09" status="review"/>
+    <revision version="gnome:42" status="final" date="2022-02-27"/>
 
     <credit type="author copyright">
       <name>Michael Hill</name>
@@ -38,7 +35,7 @@
       <p>Click <gui>Displays</gui> to open the panel.</p>
     </item>
     <item>
-      <p>Click <gui>Night Light</gui> in the header bar to open the settings.</p>
+      <p>Click <gui>Night Light</gui> to open the settings.</p>
     </item>
     <item>
       <p>Ensure the <gui>Night Light</gui> switch is set to on.</p>
diff --git a/gnome-help/C/look-background.page b/gnome-help/C/look-background.page
index 16529012..859f5b93 100644
--- a/gnome-help/C/look-background.page
+++ b/gnome-help/C/look-background.page
@@ -6,12 +6,8 @@
   <info>
     <link type="guide" xref="prefs-display"/>
 
-    <revision pkgversion="3.8.0" version="0.3" date="2013-03-09" status="candidate"/>
-    <revision pkgversion="3.10" date="2013-11-07" status="review"/>
-    <revision pkgversion="3.13.92" date="2014-09-22" status="candidate"/>
-    <revision pkgversion="3.28" date="2018-04-09" status="review"/>
-    <revision pkgversion="3.34" date="2019-11-12" status="review"/>
     <revision pkgversion="3.38.1" date="2020-11-04" status="review"/>
+    <revision version="gnome:42" status="final" date="2022-03-02"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
@@ -52,21 +48,50 @@
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
-    <desc>Set an image as your desktop background.</desc>
+    <desc>Choose a style and set a background.</desc>
   </info>
 
-  <title>Change the desktop background</title>
+  <title>Change the appearance of your desktop</title>
+  
+  <p>You can change the look of things that appear on the screen by
+  setting the style preference to light or dark. You can choose an image or
+  wallpaper as your desktop background.</p>
+  
+<section id="style">
+  <title>Light or Dark Style</title>
+  <p>To switch between light and dark desktop styles:</p>
+  
+  <steps>
+    <item>
+      <p>Open the <gui xref="shell-introduction#activities">Activities</gui>
+      overview and start typing <gui>Appearance</gui>.</p>
+    </item>
+    <item>
+      <p>Click <gui>Appearance</gui> to open the panel. The currently selected
+      style is shown at the top surrounded by a blue border.</p>
+    </item>
+    <item>
+      <p>Click to choose <gui>Light</gui> or <gui>Dark</gui>.</p>
+    </item>
+    <item>
+      <p>The setting is applied immediately.</p>
+    </item>
+  </steps>
+  
+</section>
 
-  <p>To change the image used for your backgrounds:</p>
+<section id="background">
+  <title>Background</title>
+  <p>To change the image used for your background:</p>
 
   <steps>
     <item>
       <p>Open the <gui xref="shell-introduction#activities">Activities</gui>
-      overview and start typing <gui>Background</gui>.</p>
+      overview and start typing <gui>Appearance</gui>.</p>
     </item>
     <item>
-      <p>Click <gui>Background</gui> to open the panel. The currently selected
-      wallpaper is shown at the top.</p>
+      <p>Click <gui>Appearance</gui> to open the panel. The currently selected
+      wallpaper is shown at the top in the preview for the current style.</p>
     </item>
     <item>
       <p>There are two ways to change the image used for your backgrounds:</p>
@@ -101,5 +126,7 @@
       workspace</link> to view your entire desktop.</p>
     </item>
   </steps>
+  
+  </section>
 
 </page>
diff --git a/gnome-help/C/look-display-fuzzy.page b/gnome-help/C/look-display-fuzzy.page
index e265859f..2d4b3bfd 100644
--- a/gnome-help/C/look-display-fuzzy.page
+++ b/gnome-help/C/look-display-fuzzy.page
@@ -4,12 +4,11 @@
       id="look-display-fuzzy">
 
   <info>
+    <link type="guide" xref="prefs-display#problems"/>
     <link type="guide" xref="hardware-problems-graphics"/>
 
-    <revision pkgversion="3.8.0" version="0.3" date="2013-03-09" status="candidate"/>
-    <revision pkgversion="3.9.92" date="2013-10-11" status="candidate"/>
-    <revision pkgversion="3.13.92" date="2014-09-22" status="review"/>
     <revision pkgversion="3.28" date="2018-07-28" status="review"/>
+       <revision version="gnome:42" status="final" date="2022-02-27"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
@@ -45,13 +44,10 @@
   <steps>
     <item>
       <p>Open the <gui xref="shell-introduction#activities">Activities</gui>
-      overview and start typing <gui>Settings</gui>.</p>
+      overview and start typing <gui>Displays</gui>.</p>
     </item>
     <item>
-      <p>Click on <gui>Settings</gui>.</p>
-    </item>
-    <item>
-      <p>Click <gui>Displays</gui> in the sidebar to open the panel.</p>
+      <p>Click <gui>Displays</gui> to open the panel.</p>
     </item>
     <item>
       <p>Try some of the <gui>Resolution</gui> options and select the one that
diff --git a/gnome-help/C/look-resolution.page b/gnome-help/C/look-resolution.page
index 9e6cbab9..530ebf2f 100644
--- a/gnome-help/C/look-resolution.page
+++ b/gnome-help/C/look-resolution.page
@@ -4,15 +4,11 @@
       id="look-resolution">
 
   <info>
-    <link type="guide" xref="prefs-display"/>
+    <link type="guide" xref="prefs-display" group="#first"/>
     <link type="seealso" xref="look-display-fuzzy"/>
 
-    <revision pkgversion="3.8.0" version="0.3" date="2013-03-09" status="candidate"/>
-    <revision pkgversion="3.10" date="2013-11-07" status="review"/>
-    <revision pkgversion="3.13.92" date="2014-09-22" status="candidate"/>
-    <revision pkgversion="3.28" date="2018-07-19" status="review"/>
-    <revision pkgversion="3.33" date="2019-07-19" status="candidate"/>
     <revision pkgversion="3.34" date="2019-11-12" status="review"/>
+    <revision version="gnome:42" status="final" date="2022-02-27"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
diff --git a/gnome-help/C/media.page b/gnome-help/C/media.page
index b9806a19..e6552ad7 100644
--- a/gnome-help/C/media.page
+++ b/gnome-help/C/media.page
@@ -18,8 +18,8 @@
     </credit>
 
    <title type="link" role="trail">Media</title>
-   <desc>Use your media files, and connect to cameras, digital
-   audio players, and more.</desc>
+   <desc>Manage your sound devices, use your media files, connect to external
+   devices, and more.</desc>
    <uix:thumb role="experimental-gnome-tiles" src="figures/tile-media.svg"/>
    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
diff --git a/gnome-help/C/power-whydim.page b/gnome-help/C/power-whydim.page
index 867dfe73..6789d137 100644
--- a/gnome-help/C/power-whydim.page
+++ b/gnome-help/C/power-whydim.page
@@ -5,15 +5,11 @@
 
   <info>
     <link type="guide" xref="power#saving"/>
+    <link type="guide" xref="prefs-display#problems"/>
     <link type="guide" xref="hardware-problems-graphics"/>
 
-    <revision pkgversion="3.7.1" version="0.2" date="2012-11-16" status="outdated"/>
-    <revision pkgversion="3.10" date="2013-10-29" status="review"/>
-    <revision pkgversion="3.18" date="2015-09-29" status="final"/>
-    <revision pkgversion="3.20" date="2016-06-15" status="final"/>
-    <revision pkgversion="3.28" date="2018-07-28" status="review"/>
-    <revision pkgversion="3.34" date="2019-10-28" status="review"/>
     <revision pkgversion="41" date="2021-09-08" status="review"/>
+    <revision version="gnome:42" status="final" date="2022-02-27"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
diff --git a/gnome-help/C/prefs-display.page b/gnome-help/C/prefs-display.page
index 653c0e8b..d71d3609 100644
--- a/gnome-help/C/prefs-display.page
+++ b/gnome-help/C/prefs-display.page
@@ -1,9 +1,11 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="guide" style="task"
+      type="guide" style="2column task"
       id="prefs-display">
   <info>
 
     <link type="guide" xref="prefs"/>
+    
+    <revision version="gnome:42" status="final" date="2022-02-27"/>
 
     <credit type="author">
       <name>Shaun McCance</name>
@@ -22,4 +24,9 @@
 
 <title>Display &amp; screen</title>
 
+<section id="problems">
+  <title>Problems</title>
+  <links type="topic" style="2column"/>
+</section>
+
 </page>
diff --git a/gnome-help/C/session-screenlocks.page b/gnome-help/C/session-screenlocks.page
index 50591c2f..65927358 100644
--- a/gnome-help/C/session-screenlocks.page
+++ b/gnome-help/C/session-screenlocks.page
@@ -4,15 +4,11 @@
       id="session-screenlocks">
 
   <info>
-    <link type="guide" xref="prefs-display"/>
+    <link type="guide" xref="prefs-display#problems"/>
     <link type="guide" xref="hardware-problems-graphics"/>
 
-    <revision pkgversion="3.8" version="0.3" date="2013-03-09" status="candidate"/>
-    <revision pkgversion="3.10" date="2013-11-03" status="review"/>
-    <revision pkgversion="3.13.92" date="2014-09-22" status="candidate"/>
-    <revision pkgversion="3.28" date="2018-07-19" status="review"/>
-    <revision pkgversion="3.34" date="2019-11-12" status="review"/>
     <revision pkgversion="3.38.4" date="2021-03-07" status="review"/>
+    <revision version="gnome:42" status="final" date="2022-02-27"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>


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