@@ -3,6 +3,7 @@ title = "Messaging"
4template = "doc.html"
4template = "doc.html"
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,23 +28,18 @@ take a look at its [documentation](./docs/learn/arvo/hall.md).
28## Quickstart
29## Quickstart
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 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−in `~dopzod/urbit-help`. It's the place to get help, ask questions and chat about
32+
33−Urbit in general.
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`.
35−There are two ways of using Talk: from the terminal running the Urbit process,
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.
36−or through a web UI available at `http://localhost:8080/~~/talk`. This
37−quick-start guide will cover the first method.
39### Joining a Channel
37### Joining a Channel
41−In Hall, a medium for a message is called a _circle_. There are four types of
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.
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.
46Let's join the `~dopzod/urbit-help` channel. Use `ctrl-x` to switch from Dojo to Talk.
41Let's join the `~dopzod/urbit-help` channel. Use `ctrl-x` to switch from Dojo to Talk.
@@ -65,6 +61,18 @@ You'll see your message printed below messages from others that came before it:
65~your-urbit= Hello, world!
61~your-urbit= Hello, world!
64+### Subscribing to a Channel in Landscape
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.
71+;join ~dopzod/urbit-help
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".
68### Direct Messaging
76### Direct Messaging
70To send a direct message to someone, first set your audience:
78To send a direct message to someone, first set your audience:
@@ -188,9 +196,7 @@ will print as
189#### Replies
197#### Replies
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
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.
196~some-urbit= Hello! How are you?
202~some-urbit= Hello! How are you?