diff --git a/readme.md b/readme.md
index 30cff40..9ed6924 100644
--- a/readme.md
+++ b/readme.md
@@ -1,3 +1,23 @@
 # Solr Backend Conf for Materio drupal 8
 
-solr search backend used by search_api and search_api_solr in drupal 8 instance of materio.com 
+solr search backend used by search_api and search_api_solr in drupal 8 instance of materio.com
+
+## Structure
+
+One configset per core (Solr standalone, `configSetBaseDir` in `solr.xml`):
+
+- `materio_base/conf/` : core `materio_base` (search_api server `materio`)
+- `materio_autocomplete/conf/` : core `materio_autocomplete` (search_api server `database_search_autocomplete`)
+
+No index, no `core.properties` here: they live in each instance's SOLR_HOME.
+
+## Deployment (CT-materio)
+
+| branch | clone (= configSetBaseDir)            | Solr instance                         |
+|--------|---------------------------------------|---------------------------------------|
+| prod   | /var/www/d8.materio.com/solr          | service `solr`, :8983, /var/solr      |
+| stage  | /var/www/d8.stage.materio.com/solr    | service `solr-stage`, :8984, /var/solr-stage |
+
+`git push materio.com <branch>` → `post-receive` → `deploy-solr.sh` of the site:
+`git pull --ff-only` in the clone, then RELOAD of both cores (no restart).
+A failing RELOAD keeps the previous config live.