@@ -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,14 +28,14 @@ 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
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
3232in `~dopzod/urbit-help`. It's the place to get help, ask questions and chat about
3333Urbit in general.
3434
3535There 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.
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+
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.
3839
3940### Joining a Channel
4041
@@ -44,6 +45,7 @@ accessible chatroom for general use. We'll discuss the other three
4445kinds in the [manual](#manual) section.
4546
4647Let's join the `~dopzod/urbit-help` channel. Use `ctrl-x` to switch from Dojo to Talk.
48+
4749Then:
4850
4951```
@@ -65,6 +67,18 @@ You'll see your message printed below messages from others that came before it:
6567~your-urbit= Hello, world!
6668```
6769
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+
6882### Direct Messaging
6983
7084To send a direct message to someone, first set your audience: