docs: Complete initial copy for tutorial.

Author: klfoulk16

docs/getting-started.md

@@ -8,18 +8,18 @@ If you encountered any issues above or have any queries, feel free to ask for he
 I would like you to try out a few of our keyboard shortcuts and send a couple message to help you get familiar with zulip terminal. Here's an overview of the features I'll be walking you through:
 
 ### Overview
-0. Open the App
+0. [Open the App](#Open-the-App)
 1. [Understand the Layout](#Understand-the-Layout)
 2. [Shortcuts](#Shortcuts)
-3. Reading Messages
-4. What does Narrow Mean?
-i. [Narrow to a Stream](#Narrow-to-a-Stream)
-ii. [Narrow to a Topic in a Stream](#Narrow-to-a-Topic-in-a-Stream)
-iii. Switch Topics and/or Streams
-5. Sending Messages
-i. [Create a New Topic](#Create-a-New-Topic)
-ii. [Reply to a Message](#Reply-to-a-Message)
-iii. [Send a Private Message](#Send-a-Private-Message)
+3. [Reading Messages](#Reading-Messages)
+4. [What does Narrow Mean?](#What-does-Narrow-Mean?)
+    + [Narrow to a Stream](#Narrow-to-a-Stream)
+    + [Narrow to a Topic in a Stream](#Narrow-to-a-Topic-in-a-Stream)
+    + [Switch Topics and/or Streams](#Switch-Topics-and/or-Streams)
+5. [Sending Messages](#Sending-Messages)
+    + [Create a New Topic](#Create-a-New-Topic)
+    + [Reply to a Message](#Reply-to-a-Message)
+    + [Send a Private Message](#Send-a-Private-Message)
 6. [Edit a Message's Text or Topic](#Edit-a-Message's-Text-or-Topic)
 7. [Close Zulip Terminal](#Close-Zulip-Terminal)
 
@@ -61,8 +61,8 @@ You can use narrows to filter which messages you want displayed in the middle co
 
 ### What does 'Narrow' mean?
 
-** Noun: A narrow is a set of filters for Zulip messages, that can be based on many different factors (like sender, stream, topic, search keywords, etc.).
-** Verb: Essentially the process navigating to a more specific narrow. Ie to go from viewing a stream to a topic within that stream.
++ **Noun**: A narrow is a set of filters for Zulip messages, that can be based on many different factors (like sender, stream, topic, search keywords, etc.).
++ **Verb**: Essentially the process navigating to a more specific narrow. For example, to go from viewing a stream to a topic within that stream.
 
 #### How to Tell What Your Current Narrow Is
 
@@ -73,15 +73,12 @@ Image with circle around 'all messages' at top of middle column.
 #### Narrow to a Stream
 Narrowing to a stream implies you have set middle column to show messages present in only that stream. There are several different ways to narrow to a stream:
 
-1. Using <kbd>z</kbd>.
 
-If you're scrolling through All Messages <kbd>a</kbd> and want to only see messages from a specific stream, first make sure your cursor is on a message from the stream you want to narrow to. Then press <kbd>z</kbd>.
-
-2. Using the Arrow Keys
+1. Using the Arrow Keys
 
 For this example, let's try narrowing to [# backend](https://chat.zulip.org/#narrow/stream/3-backend) from zulip terminal. Press <kbd>left</kbd> to navgiate to the left column. Then press the <kbd>down</kbd> key until your cursor rests on `backend`. Press enter to narrow to the stream.
 
-3. Use Search to Narrow to a Stream
+2. Use Search to Narrow to a Stream
 
 Narrowing to backend was easy because it was near the top of the streams list, but say you want to narrow to a stream that's farther down or isn't even displayed in the streams list...in this case you can use Search.
 
@@ -93,7 +90,7 @@ Narrowing to a stream implies you have set middle column to show messages presen
 
 1. Using <kbd>z</kbd>
 
-If you're scrolling through the messages in a stream and want to only see messages from a specific topic, first make sure your cursor is on a message from the topic you want to narrow to. Then press <kbd>z</kbd>. If you aren't yet in that stream, first this will narrow you to the message's stream. Press <kbd>z</kbd> again to narrow to the topic.
+If you're scrolling through the messages in a stream (or in all messages) and want to only see messages from a specific topic, first make sure your cursor is on a message from the topic you want to narrow to. Then press <kbd>z</kbd>. If you aren't yet in that stream, first this will narrow you to the message's stream. Press <kbd>z</kbd> again to narrow to the topic.
 
 2. Using <kbd>t</kbd> and the Arrow Keys
 
@@ -105,17 +102,26 @@ Just like with example two, make sure your cursor is in the left column and rest
 
 #### Switching Topic and Stream
 
-To go back out of a stream/topic use <kbd>esc</kbd> to go back to wherever you where last.
+Use <kbd>esc</kbd> to go back to wherever you where last.
 
 ### Sending Messages
 
+To reply to a message in a narrow (stream/topic/PM), rest your cursor on the message you want to reply to and then type <kbd>r</kbd>. Type your message in the Message box that pops up at the bottom of the middle column. Type <kbd>ctrl</kbd><kbd>d</kbd> to send. If you change your mind and don't want to send the message, type <kbd>esc</kbd> to get out of the message editor.
+
 #### Create a New Topic
 
-#### Reply to a Message
+To send a new message to a stream, type <kbd>c</kbd> and a message editor will pop open at the bottom of the middle column. Make sure your cursor is in the middle column, otherwise nothing will happen when you type <kbd>c</kbd>.
+
+By default this will send a new message to your current stream. Let's send a test message to [# test here](https://chat.zulip.org/#narrow/stream/7-test-here). If you're not already in the # test here stream, replace the stream name with test here. Add a topic and the message content. Use <kbd>tab</kbd> to navigate through the Message editor sections. Type <kbd>ctrl</kbd><kbd>d</kbd> to send.
 
 #### Send a Private Message
 
+To send a private message type <kbd>x</kbd> from anywhere in Zulip Terminal. A message editor box will pop open at the bottom of the middle column. Type in the name of the person (or people) you'd like to send a PM to. Then type in the body of the message. Type <kbd>ctrl</kbd><kbd>d</kbd> to send.
+
 ### Edit a Message's Text or Topic
-If you erase the entire message, the message will show up as "deleted".
 
-### Close Zulip Terminal
+To edit a message, first make sure your cursor is resting on the message you want to edit then type <kbd>e</kbd>. If you erase the entire message, the message will show up as "deleted". Type <kbd>ctrl</kbd><kbd>d</kbd> to update the message.
+
+### Close Zulip Terminal
+
+To exit out of the Zulip Terminal app, type <kbd>ctrl</kbd><kbd>c</kbd>.