[gnome-terminal/wip/mallard-merge: 6/234] help: update introduction.page



commit 6612b2b615fd58e64219b4220ec18d7da2c56098
Author: Sindhu S <sindhus live in>
Date:   Thu Jan 10 16:13:00 2013 +0530

    help: update introduction.page
    
    Added seealso link to overview1.page.
    Changed page status from stub to draft.
    Removed review comments.
    Modified explanation about Terminal.
    Added correct <title> and <desc> tag for screenshot.

 help/C/introduction.page |   30 +++++++++---------------------
 1 files changed, 9 insertions(+), 21 deletions(-)
---
diff --git a/help/C/introduction.page b/help/C/introduction.page
index e35dc43..6202d08 100644
--- a/help/C/introduction.page
+++ b/help/C/introduction.page
@@ -2,7 +2,9 @@
       type="guide"
       id="introduction">
   <info>
-    <revision version="0.1" date="2013-01-08" status="stub"/>
+    <revision version="0.1" date="2013-01-08" status="draft"/>
+    <link type="guide" xref="index"/>
+    <link type="seealso" xref="overview1"/>
 
     <credit type="author copyright">
       <name>Sindhu S</name>
@@ -15,34 +17,20 @@
       <years>2013</years>
     </credit>
 
-    <link type="guide" xref="index"/>
-
-    <desc>Introduction to <app>Terminal</app></desc>
-<!-- Try not to use the same terms in the title and description. For example,
-     the description would be better as "What is a terminal?". That would also
-     be more consistent with the desired tone (I will elaborate by email). -->
+    <desc>What is a Terminal?</desc>
   </info>
 
   <title>Introduction</title>
 
-  <p><app>Terminal</app> is a terminal emulator application for accessing a
-  UNIX shell environment that can be used to run programs which are available
-  on your system. <app>Terminal</app> emulates xterm which supports escape
-  sequences that control cursor position and colors.</p>
-<!-- In this context, xterm is an application type, not the application. We
-     need to try making this clear as there is potential for confusion here,
-     especially for our target audience who are likely to not know what we're
-     talking about here. -->
+  <p><app>Terminal</app> is a terminal emulator application for accessing a UNIX shell environment which can 
be used to run programs available on your system. </p>
+
+  <p><app>Terminal</app> supports escape sequences that control cursor position and colors.</p>
 
   <figure>
-    <desc>GNOME Terminal</desc>
+    <title>GNOME Terminal</title>
+    <desc>Screenshot of GNOME <app>Terminal</app></desc>
     <media type="image" src="figures/gnome-terminal.png" width="700">
-      <p>Screenshot of GNOME <app>Terminal</app></p>
     </media>
   </figure>
-<!-- Images should not be in a table unless they *have* to be. Also indent the
-     first element in situations like this as you would a paragraph. See
-     http://projectmallard.org/about/learn/media.html#figures - note that the order
-     of the tags inside <figure> matters!-->
 
 </page>


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