Update messaging documentation

Messages.rst

@@ -56,14 +56,29 @@ Press one of the contacts to continue chatting with them.
 Start a New SMS Chat
 ~~~~~~~~~~~~~~~~~~~~
 
-To start an SMS chat with a new contact, press the button at the top-right of the screen to add a new contact. This will open a page that lets you input the name and phone number for your contact. Select **SMS** as your chat account if it is not the default option.
+To start an SMS chat quickly, tap inside the search bar and enter a phone number. An item should appear below the search bar as you type.
 
-.. image:: images/chatty/chatty-new-contact.png
+.. image:: images/chatty/chatty-start-chat-number.png
    :align: center
+   :scale: 50%
+   :alt: Starting a new chat with a phone number
+
+When you have entered the phone number, tap the item to start an SMS chat.
+
+To start an SMS chat with a new contact, press the button at the top-right of the screen to add a new contact. This will open a page that lets you input the name and phone number for your contact. Select **SMS** as your chat account if it is not the default option.
+
+.. |new-sms-contact| image:: images/chatty/chatty-new-contact.png
    :scale: 50%
    :alt: Adding a new SMS contact
+.. |new-sms-with-xmpp-contact| image:: images/chatty/chatty-new-contact-xmpp.png
+   :scale: 50%
+   :alt: Adding a new SMS contact with an XMPP option present
+
+.. centered:: |new-sms-contact| |new-sms-with-xmpp-contact|
+
+Press **Add to Contacts** to add the contact -- this will open the **Contacts** application. You can send a message to the new contact from within **Contacts** or return to **Chats** to start a conversation from the **Start Chat** screen.
 
-When you have entered the phone number and optional name for your new contact, press **Add Contact** to add the contact and start composing a new message. If the contact's number is already known, the **Add Contact** button will be disabled.
+When a new conversation has started, it will be shown in a layout like the image below, with incoming messages on the left and outgoing ones on the right.
 
 .. image:: images/chatty/chatty-sms-conversation.png
    :align: center
@@ -77,12 +92,16 @@ Start a New XMPP Chat
 
 Before starting an XMPP chat you need to add an XMPP account to **Chats** -- see the :ref:`librem_5_messages_adding_account` section below.
 
-To start an SMS chat with a new contact, press the button at the top-right of the screen to add a new contact. This will open a page that lets you input the ID of your contact. Select your XMPP ID as your chat account if it is not the default option.
+To start an SMS chat with a new contact, press the button at the top-right of the screen to add a new contact. This will open a page that lets you input the ID of your contact. Select your Jabber/XMPP ID as your chat account if it is not the default option.
 
-.. image:: images/chatty/chatty-start-chat-new-xmpp-contact.png
-   :align: center
+.. |new-xmpp-contact| image:: images/chatty/chatty-start-chat-new-xmpp-contact.png
    :scale: 50%
    :alt: Adding a new XMPP contact
+.. |new-xmpp-contact-filled| image:: images/chatty/chatty-start-chat-new-xmpp-contact-filled.png
+   :scale: 50%
+   :alt: Adding a new XMPP contact with details filled in
+
+.. centered:: |new-xmpp-contact| |new-xmpp-contact-filled|
 
 When you have entered the Jabber ID and an optional name for your new contact, press **Add Contact** to add the contact and start composing a new message. If the contact's ID is already known, the **Add Contact** button will be disabled.
 
@@ -100,6 +119,19 @@ If you accepted the contact, you should be able to continue the chat with them.
    :scale: 50%
    :alt: Continuing an XMPP chat
 
+Individual conversations can be configured by accessing the **Chat Details** page via the menu at the top-right of the screen.
+
+.. |xmpp-chat-menu| image:: images/chatty/chatty-chat-xmpp-menu.png
+   :scale: 50%
+   :alt: Opening the XMPP chat menu
+.. |xmpp-chat-details| image:: images/chatty/chatty-chat-xmpp-details.png
+   :scale: 50%
+   :alt: Viewing the XMPP chat details
+
+.. centered:: |xmpp-chat-menu| |xmpp-chat-details|
+
+As well as details about the connection, you can enable and disable notifications for newly received messages specifically in this conversation.
+
 You can return to the **Chats** list by pressing the back button at the top-left of the screen.
 
 Leaving a Chat
@@ -168,7 +200,7 @@ The new account should now be shown in the list. By default, the account is acti
 
 An animation may be shown to indicate that the server is being contacted.
 
-If you wish to disable the account, slide the switch left into the off position.
+If you wish to disable the connection to the server for the account, slide the switch left into the off position.
 
 Editing and Deleting an Account
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~