diff --git a/README.md b/README.md
index b0eadb747..3e3100113 100644
--- a/README.md
+++ b/README.md
@@ -252,7 +252,8 @@ EOF
 
 #### Indentation
 
-Tree-sitter based indentation.
+Indentation based on treesitter for the `=` operator.
+**NOTE: This is an experimental feature**.
 
 ```vim
 lua <<EOF
diff --git a/doc/nvim-treesitter.txt b/doc/nvim-treesitter.txt
index 7c7743271..07b9cd10d 100644
--- a/doc/nvim-treesitter.txt
+++ b/doc/nvim-treesitter.txt
@@ -170,7 +170,8 @@ Supported options:
 ------------------------------------------------------------------------------
 INDENTATION                                  *nvim-treesitter-indentation-mod*
 
-Indentation based on treesitter for the |=| operator
+Indentation based on treesitter for the |=| operator.
+NOTE: this is an experimental feature.
 
 Query files: `indents.scm`.
 Supported options: