diff --git a/src/addons/fit/README.md b/src/addons/fit/README.md
new file mode 100644
index 00000000..68f01589
--- /dev/null
+++ b/src/addons/fit/README.md
@@ -0,0 +1,3 @@
+## fit addon
+
+The fit addon adjusts the dimensions of the terminal to match best fit its parent element container. `fit` will only work when the element is visible.