docs: Add macros to the *Pin a stream* doc.

This commit is contained in:
Cynthia Lin 2017-01-05 11:00:15 -08:00 committed by Tim Abbott
parent 1796de44a8
commit b0f867357d
1 changed files with 20 additions and 39 deletions

View File

@ -1,52 +1,33 @@
# Pinning a stream # Pinning a stream
Pinning a stream will put that stream at the top of your streams sidebar. If you are subscribed to a lot of streams, pinning important streams to the top
If you are subscribed to a lot of streams, of the **Streams** section on your left sidebar can be a good way to organize
pinning your favorite streams can be a good way to keep things organized. streams.
## How to pin a stream ## Pinning a stream using the left sidebar
There are two easy ways to pin a stream: If you want to quickly pin a single stream, you can do so through the stream sidebar.
### Pinning a stream using the sidebar {!stream-actions.md!}
The quickest way to pin a stream is by using the 2. Click on the {!down-chevron.md!} Select the **Pin stream (stream name) to top**
**Pin stream ... to top** feature on the sidebar. option from the actions dropdown.
1) On the sidebar, hover over the stream you want to pin and press the 3. Upon selecting the **Pin stream (stream name) to top** option, the selected
arrow to the right of the stream name. stream will be pinned the top of the **Streams** section, confirming the success
of your pinning.
![Arrow](/static/images/help/streams-arrow.png) ### Pinning a stream using the [Subscriptions](/#subscriptions) page
2) A menu will pop up. Press **Pin stream ... to top**. If you want to pin multiple streams at once, you should pin streams through the [Subscriptions](/#subscriptions) page.
![Sidebar menu](/static/images/help/streams-pin-sidebar.png) {!subscriptions.md!}
{!filter-streams.md!}
### Pinning a stream using the stream settings 2. Select the stream you want to pin in the [Subscriptions](/#subscriptions) page; {!stream-settings.md!}
The other way to pin a stream is by ticking the **Pin stream to top of 3. Select the **Pin stream to top of left sidebar** option in **Stream Settings**.
left sidebar** box in the stream settings.
1) Open your subscription settings by pressing the gear at the top of 4. Once you close the [Subscriptions](/#subscriptions) page, the selected stream
the left sidebar. will be pinned the top of the **Streams** section, confirming the success of
your pinning.
![Browse streams](/static/images/help/streams-1.png)
2) Now select the stream you want to pin and tick the box **Pin stream
to top of left sidebar**.
![Stream settings](/static/images/help/streams-pin-settings.png)
### Result
The stream you just pinned will now be at the top of your streams list:
![Result](/static/images/help/streams-pin-result.png)
## How to unpin a stream
Unpinning a stream works the same way as pinning a stream. You can:
- Press the arrow to the right of the stream you want to unpin and
select **Unpin stream ... from top**, or
- Open your subscription settings, select the stream you want to unpin
and untick the box **Pin stream to top of left sidebar**