on master help sign in
add Landscape subscription instructions to Messaging
a10e1b2Morgan Sutherland
using/messaging.md+18−4
@@ -3,6 +3,7 @@ title = "Messaging"
3weight = 2
3weight = 2
4template = "doc.html"
4template = "doc.html"
5+++
5+++
6+
6Talk is the built-in frontend for the Urbit messaging and notifications
7Talk is the built-in frontend for the Urbit messaging and notifications
7protocol, Hall. Today we use Hall to chat and coordinate, but it's really
8protocol, Hall. Today we use Hall to chat and coordinate, but it's really
8a general purpose piece of infrastructure.
9a general purpose piece of infrastructure.
@@ -27,14 +28,14 @@ take a look at its [documentation](./docs/learn/arvo/hall.md).
27
28
28## Quickstart
29## Quickstart
29
30
30−The most common use of talk right now is as a single-instance of Slack: one main
31−channel (`~dopzod/urbit-help`) and direct messages. Everyone is more than welcome
31+The most common use of talk right now is as a single IRC or Slack channel (`~dopzod/urbit-help`) and direct messages. Everyone is more than welcome
32in `~dopzod/urbit-help`. It's the place to get help, ask questions and chat about
32in `~dopzod/urbit-help`. It's the place to get help, ask questions and chat about
33Urbit in general.
33Urbit in general.
34
34
35There are two ways of using Talk: from the terminal running the Urbit process,
35There are two ways of using Talk: from the terminal running the Urbit process,
36−or through a web UI available at `http://localhost:8080/~~/talk`. This
36+or through the Landscape web UI available at `http://localhost/~~/landscape` (in some cases, Urbit will proxy over port 8080, in which case this link becomes `http://localhost:8080/~~/landscape`).
37−quick-start guide will cover the first method.
37+
38+If you're using Landscape for the first time, you'll need to enter a code to gain access. You can obtain this code by running `+code` from the Dojo.
38
39
39### Joining a Channel
40### Joining a Channel
40
41
@@ -44,6 +45,7 @@ accessible chatroom for general use. We'll discuss the other three
44kinds in the [manual](#manual) section.
45kinds in the [manual](#manual) section.
45
46
46Let's join the `~dopzod/urbit-help` channel. Use `ctrl-x` to switch from Dojo to Talk.
47Let's join the `~dopzod/urbit-help` channel. Use `ctrl-x` to switch from Dojo to Talk.
48+
47Then:
49Then:
48
50
49```
51```
@@ -65,6 +67,18 @@ You'll see your message printed below messages from others that came before it:
65~your-urbit= Hello, world!
67~your-urbit= Hello, world!
66```
68```
67
69
70+### Subscribing to a Channel in Landscape
71+
72+In Landscape, you can always navigate to a channel by opening the menu, or using the shortcut `cmd-k`, then typing `go ~dopzod/urbit-help`. However, if you want to see messages in your inbox, you'll need to subscribe.
73+
74+Let's try. From the Talk terminal, run:
75+
76+```
77+;source %inbox ~dopzod/urbit-help
78+```
79+
80+Now, navigate to `localhost/~~/landscape`. You should see recent messages under the "Recent" tab, and if you navigate to the "All" tab, you should see your subscription to `~dopzod/urbit-help` under "Chats".
81+
68### Direct Messaging
82### Direct Messaging
69
83
70To send a direct message to someone, first set your audience:
84To send a direct message to someone, first set your audience: