Update README.md

README.md

@@ -50,6 +50,17 @@ sudo apt install wget xfonts-75dpi
 cd /tmp
 ```
 
+To successfully install `wkhtmltopdf` you need `libssl1.1.1` 
+(You may need to install it manually because in newer versions of Ubuntu (e.g. 22.04 LTS) is used newer version of libssl, 
+which is not compatible with wkhtmltopdf).
+
+``` 
+wget http://nz2.archive.ubuntu.com/ubuntu/pool/main/o/openssl/libssl-dev_1.1.1f-1ubuntu2.16_amd64.deb
+wget http://nz2.archive.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.1f-1ubuntu2.16_amd64.deb
+sudo dpkg -i libssl-dev_1.1.1f-1ubuntu2.16_amd64.deb
+sudo dpkg -i libssl1.1_1.1.1f-1ubuntu2.16_amd64.deb
+```
+
 `wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6-1/wkhtmltox_0.12.6-1.focal_amd64.deb` (choose your version)
 
 `sudo dpkg -i wkhtmltox_0.12.6-1.focal_amd64.deb` (of the correct version that you want to install)

txmatching/web/frontend/README.md

@@ -33,13 +33,16 @@ and then:
 npm -v
 ```
 
+Make sure Node.js is of the latest versions (preferably 18.0+).
+
 ### Angular
 
 In Terminal or Command line run:
 
 ```
 npm install -g @angular/cli
 ```
+(In Ubuntu based system you may need to run it with superuser rights)
 
 It will globally install Angular on your machine.
 
@@ -50,6 +53,17 @@ We use _openapi-generator_ to automatically generate TS files from swagger. Plea
 ```
 npm install -g @openapitools/openapi-generator-cli
 ```
+(In Ubuntu based system you may need to run it with superuser rights)
+
+Here comes very interesting part: openapi generator from npm comes in quite old version
+(at the time it is written) that is not very suitable us. Which shouldn't be a problem,
+because it is updated during the first run of `make generate-swagger-all`,
+but at least in Ubuntu it cannot be updated without superuser rights, so `make` commands will not work
+(by some reason it is not possible to run `make` commands with superuser rights).
+So the part of the installation is to run any openapi-generator command with superuser rights.
+For example: `sudo openapi-generator-cli validate -i txmatching/web/swagger/swagger.yaml ` - this should
+update openapi-generator as well as validate swagger.yaml. Further runs of commands from Makefile related
+to swagger should not have any problems.
 
 ---