DOCS: Edit and reformat for Channel Actions page (RocketChat#1415)

* DOCS: Edits and reformat for Channel Actions page

* Fix build errors

Author: narcher7

user-guides/channel-actions/README.md

@@ -1,69 +1,73 @@
 # Channel Actions
 
-With channels you can also do more than merely post messages and upload files, you can interact in various ways through the channel actions menu. Channel actions are located to the right of the channel title. Some of the menus are accessible by clicking on the three dots at the end of the channel header.
+Inside channels, you can also do more than post messages and upload files. Increase your interaction with messages through Channel actions.
+
+## Find channel actions
+
+To find channel actions, go to the right of the channel title and click the menu.
 
 _Channel actions vary depending on the server configuration, so the items listed below might not all be visible in your installation._
 
-## Favorites
+## Favorite
 
 To help organize and prioritize your communications, you can **favorite** (or **star**) channels, private groups, and DMs.
 
-To favorite a channel, click on the star icon to the left of the channel header (next to the room name).
+To favorite a channel, click the **star** icon to the left of the channel header.
 
-Favoriting a channel moves it to a "Favorites" section on the channels list, making it easier to access and find.
+Favoriting a channel moves it to a **Favorites** section on the channels list, making it easier to access and find.
 
 ## Channel Info
 
-Here you can see all kinds of information about the current channel. If you have the proper permissions, this information can be edited. These are the channel info options:
+Here you can see all kinds of information about the current channel. If you admin permissions, you can edit this information. These are the channel info options:
 
 - __Channel Name__: The name of the channel, how users see the title and find the channel via search.
 
-- __Topic__: The topic shows next to the title on the channel header. Great for giving more info on what the channel is about.
+- __Topic__: The topic shows next to the title on the channel header. Great for giving more info about the channel.
 
-- __Announcement__: The announcement is shown in a very visible bar under the channel header.
+- __Announcement__: Announcements post in a bar under the channel header.
 
 - __Description__: The description of the channel.
 
 - __Private__: Tells whether a channel is private, and can set the channel to private or public.
 
-- __Read Only__: Tells whether a channel is read only, and toggles the read only status on the channel. In read only channels, messages can only be posted by people with the right permission. Good for announcements channels and such.
+- __Read Only__: Tells whether a channel is read-only, and toggles the read-only status on the channel. In read-only channels, only people with admin permissions can post messages. Good for announcements channels.
 
 - __Archived__: Tells if a channel is archived, and toggles the archived status of a channel. Nobody can post messages in an archived channel, and channel search will not find that channel.
 
 - __Password__: Tells whether a channel has a password and let you set the password. If a channel has a password, other users need to enter the password to become a member of the channel.
 
-If a [retention policy](../../administrator-guides/retention-policies/) is active on this channel, a red warning box will appear saying when your messages or files will be automatically deleted.
+If a [retention policy](../../administrator-guides/retention-policies/) is active on this channel, a red warning box appears saying when messages or files are deleted.
 
 ## Search Messages
 
 Rocket Chat search supports basic search commands which work like Gmail search.
 
-Rocket Chat also supports the use of "[regular expressions](https://en.wikipedia.org/wiki/Regular_expression)". The benefits of regular expressions are great search flexibility and the ability to search chat entries in any language, even ones which are traditionally a challenge to search (like "CJK" languages - Chinese, Japanese, Korean).
+Rocket Chat also supports the use of "[regular expressions](https://en.wikipedia.org/wiki/Regular_expression)." Regular expressions provide flexibility and the ability to search chat entries in any language, even ones which are traditionally a challenge like "CJK" languages (Chinese, Japanese, Korean).
 
 ### Basic Search Commands
 
 You can use these commands before or after entering search terms:
 
-`from:me` to search for messages only created by the current user.
+- `from:me` to search for messages only created by the current user.
 
-`from:user.name` to search for messages created by a specific user. The username entered must be the format without spaces (i.e. "john.doe" and not "John Doe". To search for any time a user was mentioned, just search for their username.
+- `from:user.name` to search for messages created by a specific user. The username entered must be the format without spaces (i.e., "john.doe" and not "John Doe.") Search for any mentions of a user by searching for their username.
 
-`has:star` returns messages that are starred by the current user.
+- `has:star` returns messages that are starred by the current user.
 
-`is:pinned` or `has:pin` returns messages that are pinned in the current channel.
+- `is:pinned` or `has:pin` returns messages that pin in the current channel.
 
-`has:url` or `has:link` returns messages that contain a link.
+- `has:url` or `has:link` returns messages that contain a link.
 
-`has:location` or `has:map` returns messages that have a location attached.
+- `has:location` or `has:map` returns messages that have a location attached.
 
-`before:dd/mm/yyyy`, `after:dd/mm/yyyy` and `on:dd/mm/yyyy` return message that were created before, after, or on the provided date.
-Dashes `dd-mm-yyyy` or dots `dd.mm.yyyy` can be used instead of slashes.
+- `before:dd/mm/yyyy`, `after:dd/mm/yyyy` and `on:dd/mm/yyyy` return message that were created before, after, or on the provided date.
 
+    Dashes `dd-mm-yyyy` or dots `dd.mm.yyyy` can be used instead of slashes.
 `order:asc`, `order:ascend`, or `order:ascending` sorts messages by ascending timestamp.
 
-`order:desc`, `order:descend`, or `order:descending` sorts messages by descending timestamp.
+- `order:desc`, `order:descend`, or `order:descending` sorts messages by descending timestamp.
 
-You can also jump to where a message is located by hovering the mouse over the search result and selecting `jump to message`.
+    You can also jump to where a message is located by hovering the mouse over the search result and selecting `jump to message.`
 
 ### Regex
 
@@ -76,22 +80,22 @@ These references tell more about the powerful world of regex:
 
 ## Members List
 
-Here you can see all the users on channel and see more information about them. If you have the proper permission, you can manage them on your channel.
+Here you can see all the users on the channel and see more information about them. If you have the proper permission, you can manage them on your channel.
 
-At first, only the current active users are shown. To see all users, click the `show all` link.
+At first, the list only shows currently active users. To see all users, click the **show all**.
 
 To see more information on a user, click their name on the list.
 
 The user preview screen shows their name, username, any role tags they might have, and their current timezone.
-From there you can also:
+From there, you can:
 
 - Start a direct conversation with the user by clicking the `conversation` option
 
 - Start a video call with the user
 
 - Set the user as channel owner
 
-- Set the user as channel moderator
+- Set the user as a channel's moderator
 
 - Mute the user
 
@@ -103,80 +107,75 @@ You can change the behavior of notifications for channels where you are a member
 
 These options are on the channel notifications tab:
 
-- __Disable Notifications__: disable all notifications for the channel.
-
-- __Audio__: select whether the channel will emit a sound whenever someone mentions you or posts a message in that channel. The sound to play can be specified.
-
-- __Desktop__: controls notification behavior when using any desktop app or browser.
-
-- __Mobile__: controls push notification behavior when using any mobile app.
+- __Disable Notifications__: Disable all notifications for the channel.
 
-- __Email__: set whether email is sent whenever someone mentions you or posts a message, or disable email notifications.
+- __Audio__: Select whether the channel will emit a sound whenever someone mentions you or posts a message in that channel. The sound played can be customized.
 
-- __Unread Room Status__: Controls whether the channel on the channel list is highlighted when there is a new message or mention.
+- __Desktop__: Controls notification behavior when using any desktop app or browser.
 
-- __Unread Tray Icon__: Controls whether the tray icon is highlighted when there are new messages or mentions on the current channel.
+- __Mobile__: Controls push notification behavior when using any mobile app.
 
-## Files List
+- __Email__: Set whether an email sends whenever someone mentions you or posts a message, or disable email notifications.
 
-A list of all the files uploaded to the current channel.
+- __Unread Room Status__: Control whether the channel on the channel list highlights when there is a new message or mention.
 
-## Mentions
+- __Unread Tray Icon__: Controls whether the tray icon highlights when there are new messages or mentions on the current channel.
 
-All messages which mentioned you in the current channel.
+## Message list options
 
-## Starred Messages
+This section details a list of all different types of lists specific to channels:
 
-All messages which you have starred in the current channel.
+- __Files List__: A list of all the files uploaded to the current channel.
 
-## Pinned Messages
+- __Mentions__: All messages that mentioned you on the current channel.
 
-All messages that were pinned on the current channel.
+- __Starred Messages__:  All messages that you have starred in the current channel.
 
-## OTR
+- __Pinned Messages__: All messages pinned to the current channel.
 
-OTR stands for __Off The Record__ Messaging.
+## Streaming
 
-OTR is basically end to end encrypted conversations.
+If the feature [Youtube Livestream](../../administrator-guides/youtube-broadcasting) is enabled, the **Streaming** Tab activates on the channel actions menu.
 
-You can only use OTR in direct messages (one-on-one) and both sides must be online.
+Through the **Streaming** tab, owners of the channel of server admins can start streaming or add another stream to the channel using a URL.
 
-To start OTR conversation, click on _START OTR_. The other user will be notified to start a OTR.
+### Start a stream
 
-After your request is confirmed by other side, messages are encrypted. Encrypted messages have a key icon on the right side.
+_Note: Depending on the settings of the server, you might be only able to link live streams from Youtube. In doubt always ask your server's admin._
 
-## Streaming
+1. Press the **Broadcast my Camera** button.
+2. Login with a Google account. Remember that streaming must be activated through your Youtube account. For more information, see [Introduction to live streaming](https://support.google.com/youtube/answer/2474026?hl=en) Google guide).
 
-If the feature [Youtube Livestream](../../administrator-guides/youtube-broadcasting) is enabled, you will see the `Streaming` Tab on the channel actions menu.
+To add a different Livestream, get the URL (must be from Youtube) for the stream, enter it into the **Livestream source** field and hit save.
 
-If you are the owner of the channel or if you are a admin server you will be able to start streaming from there, or add a current ongoing stream to the channel via url.
+You can also add a message for whenever the stream is unavailable in the **Livestream not available message** field.
 
-_Note: depending on the settings of the server you might be only able to link live streams from Youtube. In doubt always ask your server's admin._
+To add a stream with no video and only audio, use the **Enable audio only button**.
 
-To start streaming from rocket.chat just press the `Broadcast my Camera` button. After that you will be prompted to login with a google account (you need to have streaming activated on your youtube account before, see [Introduction to live streaming](https://support.google.com/youtube/answer/2474026?hl=en) Google guide).
+### (Users) Start a Live Stream
 
-You can also add a stream from Youtube with the stream link (The owner of the stream must allow the stream to be shown in other sites). To start a live stream from youtube, just add the link to it on the `Livestream source` form and hit save.
+If you are not a channel owner and there is already a live stream set to that channel, press **play** on the stream tab. This starts a pop-up with the stream embedded. The pop-up does not close even if you change channels.
 
-You can add a message to whenever the stream is unavailable in the `Livestream not available message` field.
+## Prune Messages
 
-You can also stream only the sound of the live stream with the `Enable audio only button`. This is very useful when you want to do a podcast for example.
+If you are a server admin, or your admin has given you the **clean-channel-history** permission, the **prune messages** option allows you to delete messages from a channel swiftly.
 
-If you are not a channel owner and there is already a live stream set to that channel, you will need only press play on the stream tab. Doing that will create a pop over embedded video, that can be moved around the screen and even if you change channels you will still be able to watch that stream, since the popover will not close when changing channels.
+_Note: Messages and files deleted with this option are deleted forever and cannot be recovered. Be careful and double-check your arguments before pressing Prune._
 
-## Prune Messages
+Use the following parameters to delete specific messages:
 
-If you are a server admin, or your admin has given you the `clean-channel-history` permission (for example, an admin may give that permission to channel owners), this option will allow you to swiftly delete messages from a channel.
+- `Newer than`: Deletes all messages posted **after** a particular date.
 
-`Newer than` and `Older than` allow you to set a timespan of messages to delete. If you leave both fields blank, all messages will delete. If you only wish to delete all messages posted after a specific date, you can fill in the `Newer than` field. If you wish to delete all messages posted before a specific date, you can fill in the `Older than` field. To delete messages between two dates, you fill in both fields.
+- `Older than`: Deletes all messages posted **before** a particular date.
 
-The `Users` field allows you to specify any users to delete the content from. If this field is filled, only their messages will be cleared. Leave it empty to not narrow down - the script will not care about who the content belongs to.
+Fill dates for both the `Newer than` and `Older than` fields to delete all messages.
 
-To further specify what you wish to be removed, you can use the other checkboxes:
+- `Users`: Allows you to specify any users to delete the content. When filled with a username, that user's messages deleted.
 
-- __Inclusive__: if this is checked, all messages that land on the exact start/end times you have specified will be deleted too.
+Refine the parameters above with the following options. Check each to enable:
 
-- __Exclude pinned messages__: if this is checked, it will NOT delete pinned messages.
+- __Inclusive__:  Deletes all messages that land on the exact start/end times you have specified in the `Newer than` and `Older than` fields.
 
-- __Only remove the attached files, keep messages__: if this is checked, this will only remove files, not the messages themselves.
+- __Exclude pinned messages__:  Do **not** delete pinned messages.
 
-_Messages and files deleted with this option are deleted forever and cannot be recovered. Be careful and double-check your arguments before pressing Prune._
+- __Only remove the attached files, keep messages__: Removes files but not the messages themselves