diff --git a/README.md b/README.md
index f8499e04..e7b90b7e 100644
--- a/README.md
+++ b/README.md
@@ -183,8 +183,20 @@ The following Java classes are available:
 - `String`
 - `System`
 - `Thread`
+
+Babashka supports `import` : `(import clojure.lang.ExceptionInfo)`.
+
+Babashka supports a subset of the `ns` form where you may use `:require` and `:import`:
+
+``` shellsession
+(ns foo
+  (:require [clojure.string :as str])
+  (:import clojure.lang.ExceptionInfo))
 ```
 
+For the unsupported parts of the ns form, you may use [reader
+conditionals](#reader-conditionals) to maintain compatibility with JVM Clojure.
+
 More classes can be added by request.
 
 Special vars: