Update release-0.3 branch

README.md

@@ -13,12 +13,30 @@ podman pull quay.io/konveyor/kantra:latest && podman run --name kantra-download
 
 ### MacOS
 
-**Note:** On MacOS, in order to correctly mount volumes, your podman machine must contain options:
+**Note:** There is a known [issue](https://github.com/containers/podman/issues/16106)
+with limited number of open files in mounted volumes on MacOS, which may affect kantra performance.
+
+Prior to starting your podman machine, run:
+
+```sh
+ulimit -n unlimited
+```
+
+ - This must be run after each podman machine reboot.
+
+In order to correctly mount volumes, your podman machine must contain options:
 
 ```sh
 podman machine init <vm_name> -v $HOME:$HOME -v /private/tmp:/private/tmp -v /var/folders/:/var/folders/
 ```
 
+Increase podman resources:
+
+```sh
+podman machine set <vm_name> --cpus 4 --memory 4096
+```
+
+
 Ensure that we use the connection to the VM `<vm_name>` we created earlier by default:
 
 ```sh
@@ -75,6 +93,7 @@ Flags:
 Use "kantra [command] --help" for more information about a command.
 ```
 
+
 ### Analyze
 
 Analyze allows running source code and binary analysis using [analyzer-lsp](https://github.com/konveyor/analyzer-lsp)
@@ -188,50 +207,7 @@ To run `transform rules` on application source code, run:
 kantra transform rules --input=<path/to/xmlrules> --output=<path/to/output/dir>
 ```
 
-## Quick Demos
-
-Once you have kantra installed, these examples will help you run both an 
-analyze and a transform command.
-
-### Analyze
-
-- Get the example application to run analysis on  
-`git clone https://github.com/konveyor/example-applications`
-
-- List available target technologies  
-`kantra analyze --list-targets`
-
-- Run analysis with a specified target technology  
-`kantra analyze --input=<path-to/example-applications/example-1> --output=<path-to-output-dir> --target=cloud-readiness`
-
-- Several analysis reports will have been created in your specified output path:
-
-```sh
-$ ls ./output/ -1
-analysis.log
-dependencies.yaml
-dependency.log
-output.yaml
-static-report
-```
-
-`output.yaml` is the file that contains issues report.   
-`static-report` contains the static HTML report.  
-`dependencies.yaml`contains a dependencies report.  
-
-### Transform
-
-- Get the example application to transform source code  
-`git clone https://github.com/ivargrimstad/jakartaee-duke`
-
-- View available OpenRewrite recipes  
-`kantra transform openrewrite --list-targets` 
-
-- Run a recipe on the example application  
-`kantra transform openrewrite --input=<path-to/jakartaee-duke> --target=jakarta-imports`
-
-- Inspect the `jakartaee-duke` application source code diff to see the transformation  
-
+### analyze and transform [examples](./docs/example.md)
 
 ## Code of Conduct
 Refer to Konveyor's Code of Conduct [here](https://github.com/konveyor/community/blob/main/CODE_OF_CONDUCT.md).