diff --git a/doc/Developement.md b/doc/Developement.md
new file mode 100644
index 0000000..f7fd95b
--- /dev/null
+++ b/doc/Developement.md
@@ -0,0 +1,15 @@
+# Project Setup
+
+## dev environment
+
+```
+sudo apt install npm
+sudo npm install -g npx
+
+# maybe
+sudo npm install -g shadow-cljs
+
+# in project root to retrieve all dependencies
+npm install --ignore-scripts
+npx shadow-cljs compile test
+```
diff --git a/doc/Releasing.md b/doc/Releasing.md
new file mode 100644
index 0000000..549fafb
--- /dev/null
+++ b/doc/Releasing.md
@@ -0,0 +1,17 @@
+# stable release (should be done from master)
+
+```
+#adjust [version]
+vi package.json
+vi project.clj
+
+git commit -am "release"
+git tag -am "release" [release version no]
+git push --follow-tags
+
+# bump version - increase version and add -SNAPSHOT
+vi package.json
+vi project.clj
+git commit -am "version bump"
+git push
+```
\ No newline at end of file