diff --git a/xonsh/api/README.md b/xonsh/api/README.md
new file mode 100644
index 000000000..97d31648b
--- /dev/null
+++ b/xonsh/api/README.md
@@ -0,0 +1,2 @@
+Xonsh API was introduced to reduce boilerplate code in a solutions that based on xonsh.
+We're very welcome to extend Xonsh API with shortcuts, code snippets and helpful functions.