From e201ff00cb5984a6da0dee9b9266964a40e0c226 Mon Sep 17 00:00:00 2001
From: Valentin Lorentz <progval+git@progval.net>
Date: Sat, 2 Oct 2021 15:22:19 +0200
Subject: [PATCH] Start writing a glossary

---
 glossary.rst | 60 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 index.rst    |  1 +
 2 files changed, 61 insertions(+)
 create mode 100644 glossary.rst

diff --git a/glossary.rst b/glossary.rst
new file mode 100644
index 0000000..8e8e23b
--- /dev/null
+++ b/glossary.rst
@@ -0,0 +1,60 @@
+.. _glossary:
+
+Glossary
+========
+
+.. note::
+
+   This page is a work in progress, and is still very incomplete.
+   Please send your ideas/suggestions on the IRC channel!
+
+.. glossary::
+
+   boolean
+      A value that can be either True or False.
+
+   command
+      An action that can be triggered by typing its name on IRC.
+
+   configuration variable
+   configuration value
+      A configuration variable is an object with a name that can be set
+      to different values to change the behavior of the bot.
+
+      They can be changed with the :ref:`plugin-Config` plugin.
+
+   inFilter
+      Some code that replaces messages right after
+      the bot receives them from IRC, and before it starts processing them.
+
+      This is the opposite of :term:`outFilter`.
+
+   network
+      An IRC network, ie. a group of connected IRC servers, that share
+      the same set of channels and users
+
+   outfilter
+   outFilter
+      Some code or command that replaces messages just before
+      the bot sends them to IRC.
+
+      Some plugins define them for their own purposes, such as
+      :ref:`plugin-ShrinkUrl` to replace URLs.
+      The :ref:`plugin-Filter` plugin provides an ``outfilter`` command
+      to allow bot admins to customize the messages written by their bot.
+
+      This is the opposite of :term:`inFilter`.
+
+   plugin
+      Some Python code/package that provides :term:`commands`.
+
+   server
+      A node in an IRC :term`network`. Limnoria usually does not care
+      about servers, and deals with entire networks as a single entity.
+
+   specific
+   channel-specific
+   network-specific
+      A :term:`configuration variable` is said to be channel-specific
+      and/or network-specific when it can takes different values depending
+      on the channel/network it is used in.
diff --git a/index.rst b/index.rst
index e3bcab9..09c073b 100644
--- a/index.rst
+++ b/index.rst
@@ -25,6 +25,7 @@ Contents:
     use/index.rst
     develop/index.rst
     contribute/index.rst
+    glossary.rst
 
 Indices and tables
 ==================