diff --git a/README.md b/README.md
index e8105c11aded671813207a74729130ebcce82aac..38a58277f6cad799f5da058c19344b3d0f6133e1 100644
--- a/README.md
+++ b/README.md
@@ -21,7 +21,7 @@ ZAP is a generic templating engine. Examples are provided for how to generate ar
 
 ## Quick instructions
 
-This is a node.js application. In order to run it, you need to have [npm](https://www.npmjs.com/) installed. The best way is to simply download latest install of [node](https://nodejs.org/en/download/) and you will get npm. If you have an older version of node installed on your workstation, it may give you trouble, particularly if it's very old. So make sure you have decently recent (v12.x or v14.x should work as of 2021) version of node available. Run `node --version` to check what version is picked up.
+This is a node.js application, so you need node environment installed. The best way is to simply download latest install of [node](https://nodejs.org/en/download/) and you will get node and npm. If you have an older version of node installed on your workstation, it may give you trouble, particularly if it's very old. So make sure you have latest node v16.x version, with the npm that comes with it available. Run `node --version` to check what version is picked up. v14.x mostly works as well, there is some success with v18.x, but at this point v16.x is recommended.
 
 Once you have a desired version of node, you can run:
 
diff --git a/docs/instructions.md b/docs/instructions.md
index a462278448449065ab3b869c2355529883d953a8..3e99a378a361b1e7a12378b77406fa6faf9b2d57 100644
--- a/docs/instructions.md
+++ b/docs/instructions.md
@@ -33,6 +33,18 @@ npm run electron-dev
 Following is the list of environment variables that zap tool honors:
 
 - `ZAP_LOGLEVEL`: pino log level to start with. Default is 'warn'. You can use 'debug' or 'info', for example.
+- `ZAP_TEMPSTATE`: If set to 1, then instead of .zap, a unique temporary state directory will be created.
+- `ZAP_DIR`: Sets a state directory. Can be overriden by --stateDirectory option. If unset, default is: ~/.zap
+- `ZAP_SKIP_POST_GENERATION`: If there is a defined post-generation action for zap, you can set this to variable to 1 to skip it.
+- `ZAP_REUSE_INSTANCE`: If set to 1, default behavior of zap will be to reuse existing instance.
+- `ZAP_CLEANUP_DELAY`: Amount of millisecons zap will wait for cleanups to perform. This is workaround for some SQLite bug. If unset, default is: 1500
+- `JENKINS_HOME`: When this env variable is present, zap will assume Jenkins environment. That will assume ZAP_TEMPSTATE and ZAP_SKIP_POST_GENERATION to be 1 by default.
+
+**Husky Git hooks:**
+
+Zap repo is configured with husky git hooks, that perform some
+pre-commit actions, formatting code, checking the obvious problems and similar. If you properly ran `npm install`, all these hooks should
+be installed. You can make sure they are installed by running `npx husky install`. See `.husky/pre-commit` script to review the actions executed as a pre-commit hook.
 
 **Format the files:**