diff --git a/README.md b/README.md
index d598acbfe..c10b192e3 100644
--- a/README.md
+++ b/README.md
@@ -19,6 +19,9 @@ We do have a [live Storybook](http://lion-web-components.netlify.com) which show
 
 **Please note:** This project uses Yarn [Workspaces](https://classic.yarnpkg.com/en/docs/workspaces). If you want to run all demos locally you need to get [Yarn](https://classic.yarnpkg.com/en/docs/install) and install all dependencies by executing `yarn install`.
 
+The code examples make use of [Javascript tagged template literals](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template_literals) which are a key component of the [lit-html engine](https://lit-html.polymer-project.org/) used in Lion.
+Additionally imports like `import '@lion/form/lion-form.js'` need to be transformed somehow, for example by [es-dev-server](https://open-wc.org/developing/es-dev-server.html#node-resolve).
+
 ## Features
 
 - pure es modules