@@ -1,24 +1,24 @@
2−title = "chat-cli"
2+title = "chat"
4template = "doc.html"
4template = "doc.html"
6category = "arvo"
6category = "arvo"
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.
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.
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.
15−There are several default types of chats.
15+There are four "kinds" of chats, that use different permission modes:
17− * A channel is a chat that is publicly readable and 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.
18+ * A `village` is an invite-only chat.
19− * A journal is publicly readable and privately writable, with a whitelist for authors.
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.
20+ * A `mailbox` is readable by its owner and publicly writable, with a blacklist for blocking.
22### Further Reading
22### Further Reading
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.