diff --git a/docs/index.rst b/docs/index.rst
index 9ce6e0e..4be1483 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -8,6 +8,7 @@ Blueprint is a markup language and compiler for GTK 4 user interfaces.
    :caption: Contents:
 
    setup
+   translations
    examples
 
 
diff --git a/docs/translations.rst b/docs/translations.rst
new file mode 100644
index 0000000..02816a5
--- /dev/null
+++ b/docs/translations.rst
@@ -0,0 +1,41 @@
+============
+Translations
+============
+
+Blueprint files can be translated with xgettext. To mark a string as translated,
+use the following syntax:
+
+.. code-block::
+
+   _("translated string")
+
+You'll need to use a few of xgettext flags so it will recognize the format:
+
+.. code-block::
+
+   --from-code=UTF-8
+   --add-comments
+   --keyword=_
+   --keyword=C_:1c,2
+
+If you're using Meson's i18n module, you can use the 'glib' preset:
+
+.. code-block:: meson.build
+
+   i18n.gettext('package name', preset: 'glib')
+
+Contexts
+--------
+
+Unlike most other translation libraries, which use a separate string key,
+gettext uses the English translation as the key. This is great for effortlessly
+adding new strings--you just mark them as needing translation--but it can cause
+conflicts. Two strings that are the same in English, but appear in different
+contexts, might be different in another language! To disambiguate, use ``C_``
+instead of ``_`` and add a context string as the first argument:
+
+.. code-block::
+
+   C_("shortcuts window", "Quit")
+
+The context string will be shown to translators, but will not appear in the UI.
\ No newline at end of file