diff --git a/appimage/README.rst b/appimage/README.rst
index 7e1d9f5c4..a9b605970 100644
--- a/appimage/README.rst
+++ b/appimage/README.rst
@@ -1 +1,11 @@
-This directory contains xonsh AppImage description to build with https://github.com/niess/python-appimage/.
\ No newline at end of file
+This directory contains xonsh AppImage description.
+
+The steps to build ``xonsh.AppImage`` for release:
+
+1. We're using `rever <https://github.com/regro/rever>`_ to manage release.
+
+2. The basic configuration for AppImage is in `xonsh/rever.xsh <https://github.com/xonsh/xonsh/blob/295e7f0582ff7399144939c4a56a85379417003d/rever.xsh#L49-L51>`_.
+
+3. The actual code to build appimage is in `rever/activities/appimage.py <https://github.com/regro/rever/blob/master/rever/activities/appimage.xsh>`_.
+
+See also: https://xon.sh/appimage.html