Commit 8dccc433 authored by David Boddie's avatar David Boddie 💬
Browse files

Update messaging documentation

parent 1065f8af
......@@ -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
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
......
images/chatty/chatty-chat-xmpp.png

39.8 KB | W: | H:

images/chatty/chatty-chat-xmpp.png

32.8 KB | W: | H:

images/chatty/chatty-chat-xmpp.png
images/chatty/chatty-chat-xmpp.png
images/chatty/chatty-chat-xmpp.png
images/chatty/chatty-chat-xmpp.png
  • 2-up
  • Swipe
  • Onion skin
images/chatty/chatty-menu.png

29.3 KB | W: | H:

images/chatty/chatty-menu.png

23.5 KB | W: | H:

images/chatty/chatty-menu.png
images/chatty/chatty-menu.png
images/chatty/chatty-menu.png
images/chatty/chatty-menu.png
  • 2-up
  • Swipe
  • Onion skin
images/chatty/chatty-new-contact.png

16.9 KB | W: | H:

images/chatty/chatty-new-contact.png

15.5 KB | W: | H:

images/chatty/chatty-new-contact.png
images/chatty/chatty-new-contact.png
images/chatty/chatty-new-contact.png
images/chatty/chatty-new-contact.png
  • 2-up
  • Swipe
  • Onion skin
images/chatty/chatty-start-chat.png

20.5 KB | W: | H:

images/chatty/chatty-start-chat.png

11 KB | W: | H:

images/chatty/chatty-start-chat.png
images/chatty/chatty-start-chat.png
images/chatty/chatty-start-chat.png
images/chatty/chatty-start-chat.png
  • 2-up
  • Swipe
  • Onion skin
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment