@@ -3,6 +3,7 @@ title = "Messaging"
33weight = 2
44template = "doc.html"
55+++
6+
67Talk is the built-in frontend for the Urbit messaging and notifications
78protocol, Hall. Today we use Hall to chat and coordinate, but it's really
89a general purpose piece of infrastructure.
@@ -27,23 +28,18 @@ take a look at its [documentation](./docs/learn/arvo/hall.md).
2728
2829## Quickstart
2930
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
32−in `~dopzod/urbit-help`. It's the place to get help, ask questions and chat about
33−Urbit in general.
31+The most common uses of Talk right now are communicating over a public chat channel called `~dopzod/urbit-help` and sending direct messages. Everyone is more than welcome in `~dopzod/urbit-help`. It's the place to get help, ask questions and chat about Urbit in general.
32+
33+There are two ways of using Talk: from the terminal running the Urbit process, or through the Landscape web UI available at `http://localhost/~~/landscape`.
3434
35−There 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
37−quick-start guide will cover the first method.
35+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.
3836
3937### Joining a Channel
4038
41−In Hall, a medium for a message is called a _circle_. There are four types of
42−circles, but we for now we'll be dealing with the _channel_: a publicly
43−accessible chatroom for general use. We'll discuss the other three
44−kinds in the [manual](#manual) section.
39+In Hall, a medium for a message is called a _circle_. There are four types of circles, but we for now we'll be dealing with the _channel_: a publicly accessible chatroom for general use. We'll discuss the other three kinds in the [manual](#manual) section.
4540
4641Let's join the `~dopzod/urbit-help` channel. Use `ctrl-x` to switch from Dojo to Talk.
42+
4743Then:
4844
4945```
@@ -65,6 +61,18 @@ You'll see your message printed below messages from others that came before it:
6561~your-urbit= Hello, world!
6662```
6763
64+### Subscribing to a Channel in Landscape
65+
66+In Landscape, you can always navigate to a channel by opening the menu, or using the shortcut `cmd-k`, then typing `go ~host-urbit/channel-name`. However, if you want to see messages in your inbox, you'll need to join from the Talk terminal.
67+
68+Again, that's:
69+
70+```
71+;join ~dopzod/urbit-help
72+```
73+
74+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".
75+
6876### Direct Messaging
6977
7078To send a direct message to someone, first set your audience:
@@ -188,9 +196,7 @@ will print as
188196
189197#### Replies
190198
191−To indicate what you're saying is in direct response to a specific
192−message, select the message (see Activating Lines below) and type your
193−response.
199+To indicate what you're saying is in direct response to a specific message, select the message (see Activating Lines below) and type your response.
194200
195201```
196202~some-urbit= Hello! How are you?