diff --git a/docs/kittens/choose-fonts.rst b/docs/kittens/choose-fonts.rst
new file mode 100644
index 000000000..3b7c8eafa
--- /dev/null
+++ b/docs/kittens/choose-fonts.rst
@@ -0,0 +1,41 @@
+Changing kitty fonts
+========================
+
+.. only:: man
+
+    Overview
+    --------------
+
+Terminal aficionados spend all day staring at text, as such, getting text
+rendering just right is very important. kitty has extremely powerful facilities
+for fine-tuning text rendering. It supports `OpenType features
+<https://en.wikipedia.org/wiki/List_of_typographic_features>`__ to select
+alternate glyph shapes, and `Variable fonts
+<https://en.wikipedia.org/wiki/Variable_font>`__ to control the weight or
+spacing of a font precisely. You can also :opt:`select which font is used to
+render particular unicode codepoints <symbol_map>` and you can :opt:`modify
+font metrics <modify_font>` and even :opt:`adjust the gamma curves
+<text_composition_strategy>` used for rendering text onto the background color.
+
+The first step is to select the font faces kitty will use for rendering
+regular, bold and italic text. kitty comes with a convenient UI for choosing fonts,
+in the form of the *choose-fonts* kitten. Simply run::
+
+    kitten choose-fonts
+
+and follow the on screen prompts.
+
+First, choose the family you want, the list of families can be easily filtered by
+typing a few letters from the family name you are looking for. The family
+selection screen shows you a preview of how the family looks.
+
+.. image:: ../screenshots/family-selection.png
+   :alt: Choosing a family with the choose fonts kitten
+   :width: 600
+
+Once you select a family by pressing the :kbd:`Enter` key, you
+are shown previews of what the regular, bold and italic faces look like
+for that family. You can choose to fine tune any of the faces. Start with
+fine-tuning the regular face by pressing the :kbd:`R` key. The other styles
+will be automatically adjusted based on what you select for the regular face.
+
diff --git a/docs/kittens_intro.rst b/docs/kittens_intro.rst
index aaf8faba7..60a944835 100644
--- a/docs/kittens_intro.rst
+++ b/docs/kittens_intro.rst
@@ -11,6 +11,7 @@ Extend with kittens
    kittens/diff
    kittens/unicode_input
    kittens/themes
+   kittens/choose-fonts
    kittens/hints
    kittens/remote_file
    kittens/hyperlinked_grep
diff --git a/docs/screenshots/family-selection.png b/docs/screenshots/family-selection.png
new file mode 100644
index 000000000..563c38037
Binary files /dev/null and b/docs/screenshots/family-selection.png differ