GNOME.org
 

[polari/docs] Update docs with feedback from Bug #722498 comment 16

commit a655535b10f2267482dc93b78277e87d1a6ca1cf
Author: Paul Cutler <paul r cutler gmail com>
Date:   Wed Mar 15 14:48:29 2017 -0500

    Update docs with feedback from Bug #722498 comment 16
    
    * Update screenshot to GNOME Docs standard (800x600)
    * Update connecting to channels and rooms with new features found in Polari 3.24
    * Include context popovers for messaging a user for a private chat
    * Add note for connecting to a network with a custom port
    * Update sharing to include drag and drop from Files
    * Fix typo in Channels in overview page

 help/C/images/main.png             |  Bin 15544 -> 0 bytes
 help/C/images/polari.png           |  Bin 0 -> 23775 bytes
 help/C/introduction.page           |    4 ++--
 help/C/irc-join-room.page          |   17 +++++++----------
 help/C/irc-start-conversation.page |   26 +++++++++++++++++++++-----
 help/C/network-connect.page        |   14 +++++++++-----
 help/C/overview.page               |    4 ++--
 help/C/sharing.page                |    3 ++-
 8 files changed, 43 insertions(+), 25 deletions(-)
---
diff --git a/help/C/images/polari.png b/help/C/images/polari.png
new file mode 100644
index 0000000..ccb3492
Binary files /dev/null and b/help/C/images/polari.png differ
diff --git a/help/C/introduction.page b/help/C/introduction.page
index 82347d0..97c8ad7 100644
--- a/help/C/introduction.page
+++ b/help/C/introduction.page
@@ -33,8 +33,8 @@
     <app>Polari</app> is a simple Internet Relay Chat (IRC) client which integrates with the GNOME desktop 
and enables you to chat with people around the world through large chatrooms or private messaging.
   </p>
 
-  <media type="image" mime="image/png" src="images/main.png">
-       <p>A screenshot of the main window of Polari (not connected to a network)</p>
+  <media type="image" mime="image/png" src="images/polari.png">
+       <p>Polari IRC Client</p>
   </media>
 
 </page>
diff --git a/help/C/irc-join-room.page b/help/C/irc-join-room.page
index 976c510..0bccafd 100644
--- a/help/C/irc-join-room.page
+++ b/help/C/irc-join-room.page
@@ -29,15 +29,12 @@
     <item>
       <p>Click on the <key>+</key> in the top left corner.</p>
     </item>
-       <item>
-       <p>In Join room window, type the <em>Room name</em> and <em>Password</em> if joining a 
-       password protected room.</p>
-       </item>
+    <item>
+      <p>Enter the name of the chat room you would like to join or select the chat room(s) from the list and
+      then press <gui>Join</gui>.  You can select multiple rooms from the list to join.</p>
+     </item>
+     <item>
+       <p>Click the <gui>Join</gui> button to connect to the chat room or rooms.</p>
+     </item>
   </steps>
-
-  <note style="tip">
-    <p>
-      To join multiple rooms, you need to repeat the steps above for each room.
-    </p>
-  </note>
 </page>
diff --git a/help/C/irc-start-conversation.page b/help/C/irc-start-conversation.page
index 958aebf..c61d987 100644
--- a/help/C/irc-start-conversation.page
+++ b/help/C/irc-start-conversation.page
@@ -27,18 +27,34 @@
 
   <steps>
     <item>
+      <p>Click on the name of the person in the channel you would like to start
+      a chat with.
+      </p>
+    </item>
+    <item>
+      <p>Information about the user, including their name and the last time they 
+      were active in the channel, will appear.  Click <gui>Message</gui> to start a private conversation.
+      </p>
+    </item>
+  </steps>
+    
+  <p>Another option to start a conversation with a user:</p>
+  
+  <steps> 
+    <item>
       <p>In the upper right hand corner of <app>Polari</app> a number is displayed
-      that shows the total number of users in the chat room.  Click on the 
-      number.
+      that shows the total number of users in the chat room.  Click on the number.
       </p>
     </item>
     <item>
       <p>Select the name of the user you want to message.  Information about the user,
-      including their name and the last time they were active in the channel, will appear.
-      Click <gui>Message</gui> to start a private conversation.
-      </p>
+      including their name and the last time they were active in the channel, will appear.</p>
+    </item>
+    <item>
+      <p>Click <gui>Message</gui> to start a private conversation.</p>
     </item>
   </steps>
+    
     <p>A new private conversation will start and chat room will be started. The chat room
     will be shown in the left sidebar of <app>Polari</app> with the name of the person
     you are chatting with.
diff --git a/help/C/network-connect.page b/help/C/network-connect.page
index 9672467..716ec7b 100644
--- a/help/C/network-connect.page
+++ b/help/C/network-connect.page
@@ -34,7 +34,7 @@
     in the <gui>Network Name</gui> field.
     </p>
     
-    <p>After you have connected to an IRC Network, you can connect to other IRC Networks.
+    <p>After you have connected to an IRC Network, you can also connect to other IRC Networks.
     </p>
  
   <steps>
@@ -42,15 +42,19 @@
                <p>Click on the <key>+</key> in the top left corner.</p>
        </item>
        <item>
-               <p>Click <gui>Add Network</gui> and select the IRC network you would like to join
+               <p>Click <gui>Add Network</gui> and select the IRC network from the list you would like to 
join
                or click on <gui>Custom Network</gui> and enter the details.</p>
        </item>
        <item>
-               <p>In Join room window, type the <em>Room name</em> and <em>Password</em> if joining a
-               password protected room.</p>
+               <p>Enter the name of the chat room you would like to join or select the chat room(s) from the 
list and
+               then press <gui>Join</gui>.</p>
        </item>
        <item>
-               <p>Click the <gui>Join</gui> button to connect.</p>
+               <p>Click the <gui>Join</gui> button to connect to the room or rooms..</p>
        </item>
   </steps>
+  
+  <note><p>If the IRC network you are connecting to uses a custom port, you can append it to the name of the 
network with a 
+  colon and the port number, for example <em>irc.example.org:12345</em></p>
+  </note>
 </page>
diff --git a/help/C/overview.page b/help/C/overview.page
index a0751ca..5644008 100644
--- a/help/C/overview.page
+++ b/help/C/overview.page
@@ -24,8 +24,8 @@
     Internet Relay Chat (IRC) is a means of chatting with people online using
     public and private chatrooms.  IRC networks, such as Freenode or Gimpnet, are unique
     and host their own servers with its own channels.  IRC uses a client / server model 
-    where you can use a client, such as Polari, to connect to an IRC server on and join a channel.  C
-    hannels, also known as chat rooms, are where users meet online to chat.
+    where you can use a client, such as Polari, to connect to an IRC server on and join a channel. 
+    Channels, also known as chat rooms, are where users meet online to chat.
 
   </p>  
   
diff --git a/help/C/sharing.page b/help/C/sharing.page
index 0572bca..379c83d 100644
--- a/help/C/sharing.page
+++ b/help/C/sharing.page
@@ -32,7 +32,8 @@
   <media type="image" mime="image/png" src="images/polari-paste.png"/>
   
   <p>To share an image file, drag and drop the image from <app>Files</app> into the chat box
-  in <app>Polari</app>.  You will be asked if you wish to upload the image to a public paste service.
+  in <app>Polari</app> or drag and drop a file from <app>Files</app> to <app>Polari</app>.  
+  You will be asked if you wish to upload the image to a public paste service.
   If you agree to upload the image, press the <gui>Paste</gui> button as seen in the following screenshot.
   After pressing <gui>Paste</gui>, the link to the where the image was uplaoded will be automatically 
   entered into the chat box.  Press <key>Enter</key> to share the link with the chat room.
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]