@@ -1,24 +1,24 @@
11+++
2−title = "chat-cli"
2+title = "chat"
33
44template = "doc.html"
55[extra]
66category = "arvo"
77+++
88
9−**Chat**, also referred to as `:chat-cli`, is an application that handles communication between ships.
9+**Chat** is a suite of applications that handle "instant messaging"-style communication between ships.
1010
11−There are four types of chats (lowercase). Each is a named collection of messages created by and hosted on a ship's [Hall](../hall), usually represented as `~ship-name/circle-name`. Most of Chat revolves around doing things with these chats.
11+A chat is a named collection of messages created by and hosted in a ship's chat-store, usually represented as `~ship-name/circle-name`. Most of Chat revolves around doing things with these chats.
1212
13−Circles are subscribed to by some number of ships which are permitted to post and retrieve messages from the circle.
13+Chats are subscribed to by some number of ships which are permitted to post and retrieve messages from the chat.
1414
15−There are several default types of chats.
15+There are four "kinds" of chats, that use different permission modes:
1616
17− * A channel is a chat that is publicly readable and writable, with a blacklist for blocking.
18− * A village is an invite-only chat.
19− * A journal is publicly readable and privately writable, with a whitelist for authors.
20− * A mailbox is readable by its owner and publicly writable, with a blacklist for blocking.
17+ * A `channel` is a chat that is publicly readable and writable, with a blacklist for blocking.
18+ * A `village` is an invite-only chat.
19+ * A `journal` is publicly readable and privately writable, with a whitelist for authors.
20+ * A `mailbox` is readable by its owner and publicly writable, with a blacklist for blocking.
2121
2222### Further Reading
2323
24−- [Messaging guide](@/using/operations/using-your-ship.md#messaging): A guide to using Chat.
24+- [Messaging guide](@/using/operations/using-your-ship.md#messaging): A guide to using Chat from the command line.