Add new README
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a017c07
--- /dev/null
+++ b/README.md
@@ -0,0 +1,27 @@
+[](https://github.com/apache/streampipes-website/actions/)
+# Apache StreamPipes Website + Docs
+
+## Intro
+This repository includes the website and documentation of Apache StreamPipes on [https://streampipes.apache.org](https://streampipes.apache.org).
+Two different technologies are used to create both sites:
+* The website & documentation uses [Docusaurus](https://docusaurus.io/) to create a versioned documentation.
+* The Python docs are auto-generated from the main code repo using MkDocs.
+
+Both parts are merged to a single directory during the CI process.
+
+Node.js and npm are required to build the documentation.
+
+## Build Website & Documentation
+
+* Run ``npm install`` from the ``website-v2`` directory.
+* Run ``npm run start`` to start the documentation for debugging purposes. The content will be served on ``http://localhost:3000``
+* Run ``npm run build`` to build the documentation This will create a folder ``website-v2/build`` that includes all required static files.
+* Run ``npm run ds-version NEW_VERSION`` to release a new docs version.
+
+## Deploy
+
+* First, build the website and documentation as explained above.
+* Copy the content from the `docs-python` to the ``website-v2/build`` folder into a subdirectory named ``python``.
+
+The deployment step is done automatically using the asf.yaml process.
+Code must be merged into the `master` branch in order to trigger an update of the website.
