[gnome-user-docs] Review standards for session- pages

From: Phil Bull <philbull src gnome org>
To: commits-list gnome org
Cc:
Subject: [gnome-user-docs] Review standards for session- pages
Date: Sun, 20 Mar 2011 00:23:47 +0000 (UTC)
commit 8d48f9847c0a5b5c2c7650780bf0dd90d4e75608
Author: Phil Bull <philbull gmail com>
Date:   Sat Mar 19 20:23:35 2011 -0400

    Review standards for session- pages

 gnome-help/C/session-authmethods.page |    9 +++++----
 gnome-help/C/session-language.page    |   10 ++++++----
 gnome-help/C/session-loginsound.page  |    9 ++++++---
 gnome-help/C/session-netlogin.page    |    9 +++++----
 gnome-help/C/session-screenlocks.page |    9 +++++----
 gnome-help/C/session-suspend.page     |    7 ++++---
 gnome-help/C/session.page             |    3 +++
 7 files changed, 34 insertions(+), 22 deletions(-)
---
diff --git a/gnome-help/C/session-authmethods.page b/gnome-help/C/session-authmethods.page
index 0319236..57aac1a 100644
--- a/gnome-help/C/session-authmethods.page
+++ b/gnome-help/C/session-authmethods.page
@@ -1,11 +1,12 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic"
+      style="task"
       id="session-authmethods">
 
   <info>
     <link type="guide" xref="session#login"/>
-    <desc>XXX</desc>
-    <revision pkgversion="0.1" version="0.1" date="2010-10-31" status="stub"/>
+    <desc>XXXXX</desc>
+    <revision pkgversion="3.0" version="0.1" date="2011-03-19" status="stub"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -14,8 +15,8 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>Log-in using a smart card, fingerprint reader or similar</title>
-  
+<title>Log-in using a smart card, fingerprint reader or similar</title>
+
   <comment>
    <cite date="2010-10-31" href="mailto:gnome-doc-list gnome org">GNOME Documentation Project</cite>
    <p>This one is complicated!</p>
diff --git a/gnome-help/C/session-language.page b/gnome-help/C/session-language.page
index 2db4579..78f9b2a 100644
--- a/gnome-help/C/session-language.page
+++ b/gnome-help/C/session-language.page
@@ -1,11 +1,12 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic" style="task"
+      type="topic"
+      style="task"
       id="session-language">
 
   <info>
     <link type="guide" xref="prefs#session"/>
-    <desc>Switch language at login.</desc>
-    <revision pkgversion="3.0" version="0.1" date="2011-02-25" status="candidate"/>
+    <desc>Switch to using a different language for text on the screen.</desc>
+    <revision pkgversion="3.0" version="0.1" date="2011-03-19" status="incomplete"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -14,7 +15,7 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>Change language</title>
+<title>Change language</title>
   <note style="important">
   <p>
   In order to be able to switch between languages on the login screen, support for the language must already be installed.  The easiest way to add support for different languages is at the time of installing your system.
@@ -24,6 +25,7 @@
   If all relevant language packs are installed on your system, you can change between different languages at login.  On the login screen, the bottom panel has a drop-down menu with the available language listed.  You can switch between languages by selecting a language from this menu before entering your login password.
   </p>
 
+<!-- Should also mention that the Languages capplet in the control centre can be used for this -->
 
   <comment>
    <cite date="2010-10-31" href="mailto:gnome-doc-list gnome org">GNOME Documentation Project</cite>
diff --git a/gnome-help/C/session-loginsound.page b/gnome-help/C/session-loginsound.page
index 08e5c21..d54e930 100644
--- a/gnome-help/C/session-loginsound.page
+++ b/gnome-help/C/session-loginsound.page
@@ -1,12 +1,15 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic"
+      style="task"
       id="session-loginsound">
 
   <info>
     <link type="guide" xref="prefs#sound"/>
-    <desc></desc>
+    <desc>XXXXX</desc>
 
-    <revision pkgversion="3.0" version="0.1" date="2011-03-15" status="candidate"/>
+    <revision pkgversion="3.0" version="0.1" date="2011-03-19" status="outdated"/>
+    <!-- Can you do this any more? Is there even a login sound? -->
+    
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -15,7 +18,7 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>Disable or Change Login Sound</title>
+  <title>Disable or change the login sound</title>
   <p>
    When you login to your system, a default login sound is played.  You can easily disable it, or even change it to your favorite sound.
   </p>  
diff --git a/gnome-help/C/session-netlogin.page b/gnome-help/C/session-netlogin.page
index 6ee3f3d..5aa6c70 100644
--- a/gnome-help/C/session-netlogin.page
+++ b/gnome-help/C/session-netlogin.page
@@ -1,11 +1,12 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic"
+      style="task"
       id="session-netlogin">
 
   <info>
     <link type="guide" xref="session#login"/>
-    <desc>XXX</desc>
-    <revision pkgversion="0.1" version="0.1" date="2010-10-31" status="stub"/>
+    <desc>XXXXX</desc>
+    <revision pkgversion="3.0" version="0.1" date="2011-03-19" status="stub"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -14,8 +15,8 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>Logging-in over a network</title>
-  
+<title>Log-in over a network</title>
+
   <comment>
    <cite date="2010-10-31" href="mailto:gnome-doc-list gnome org">GNOME Documentation Project</cite>
    <p>Difficult set of topics! Explain how to set-up different types of network logins, and how the user can log-in over a network via GDM etc. Mention some common problems and how to resolve them.</p>
diff --git a/gnome-help/C/session-screenlocks.page b/gnome-help/C/session-screenlocks.page
index d666528..71ac7d2 100644
--- a/gnome-help/C/session-screenlocks.page
+++ b/gnome-help/C/session-screenlocks.page
@@ -1,11 +1,12 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic"
+      style="problem"
       id="session-screenlocks">
 
   <info>
     <link type="guide" xref="session#problems"/>
-    <desc>XXX</desc>
-    <revision pkgversion="0.1" version="0.1" date="2010-10-31" status="stub"/>
+    <desc>XXXXX</desc>
+    <revision pkgversion="3.0" version="0.1" date="2011-03-19" status="stub"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -14,8 +15,8 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>The screen locks itself too quickly</title>
-  
+<title>The screen locks itself too quickly</title>
+
   <comment>
    <cite date="2010-10-31" href="mailto:gnome-doc-list gnome org">GNOME Documentation Project</cite>
    <p>The screen may lock itself quite quickly, e.g. within 5 minutes of idle time. Explain what is happening, and how to change the settings so it doesn't lock itself so quickly.</p>
diff --git a/gnome-help/C/session-suspend.page b/gnome-help/C/session-suspend.page
index f3af381..25d2339 100644
--- a/gnome-help/C/session-suspend.page
+++ b/gnome-help/C/session-suspend.page
@@ -1,11 +1,12 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic"
+      style="task"
       id="session-suspend">
 
   <info>
     <link type="guide" xref="prefs#session"/>
-    <desc></desc>
-    <revision pkgversion="3.0" version="0.1" date="2010-10-31" status="candidate"/>
+    <desc>Suspend the computer so that it uses less power but keeps your documents and applications open.</desc>
+    <revision pkgversion="3.0" version="0.1" date="2011-03-19" status="review"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -14,7 +15,7 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>Suspend the Computer</title>
+  <title>Make the computer go to sleep</title>
  <p>To suspend your computer:</p>
 <steps>
  <item>
diff --git a/gnome-help/C/session.page b/gnome-help/C/session.page
index 8bd8e49..bb81457 100644
--- a/gnome-help/C/session.page
+++ b/gnome-help/C/session.page
@@ -3,6 +3,8 @@
       id="session">
 <info>
     <link type="guide" xref="prefs#session" />
+    
+    <revision pkgversion="3.0" version="0.1" date="2011-03-19" status="stub"/>
     <credit type="author">
       <name>Natalia Ruz</name>
       <email>nruz alumnos inf utfsm cl</email>
@@ -12,6 +14,7 @@
 </info>
 
 <title>Session Settings</title>
+<!-- Needs different title, let's not refer to "sessions" -->
 
 <section id="login" style="2column">
     <title>Log-in and Log-out facts</title>
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]