(release) v3.0.0

vmware · Nov 20, 2024 · 85a48e0 · 85a48e0
1 parent 2bd50d4
commit 85a48e0
Showing 143 changed files with 4,211 additions and 190 deletions.
diff --git a/docs/versions/latest/General/Cheatsheets/abx-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/abx-plugin-arguments.md
@@ -1,7 +1,7 @@
 [ERROR] 
 [ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
 [ERROR] artifactId: 'abx-package-maven-plugin'
-[ERROR] version: '2.43.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:abx-package-maven-plugin:2.43.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:abx-package-maven-plugin:jar:2.43.1-SNAPSHOT
+[ERROR] version: '2.44.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:abx-package-maven-plugin:2.44.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:abx-package-maven-plugin:jar:2.44.1-SNAPSHOT
 [ERROR] -> [Help 1]
 [ERROR] 
 [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.

diff --git a/docs/versions/latest/General/Cheatsheets/actions-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/actions-plugin-arguments.md
@@ -1,7 +1,7 @@
 [ERROR] 
 [ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
 [ERROR] artifactId: 'o11n-actions-package-maven-plugin'
-[ERROR] version: '2.43.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-actions-package-maven-plugin:2.43.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:o11n-actions-package-maven-plugin:jar:2.43.1-SNAPSHOT
+[ERROR] version: '2.44.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-actions-package-maven-plugin:2.44.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:o11n-actions-package-maven-plugin:jar:2.44.1-SNAPSHOT
 [ERROR] -> [Help 1]
 [ERROR] 
 [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.

diff --git a/docs/versions/latest/General/Cheatsheets/bsc-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/bsc-plugin-arguments.md
@@ -1,7 +1,7 @@
 [ERROR] 
 [ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
 [ERROR] artifactId: 'bsc-package-maven-plugin'
-[ERROR] version: '2.43.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:bsc-package-maven-plugin:2.43.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:bsc-package-maven-plugin:jar:2.43.1-SNAPSHOT
+[ERROR] version: '2.44.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:bsc-package-maven-plugin:2.44.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:bsc-package-maven-plugin:jar:2.44.1-SNAPSHOT
 [ERROR] -> [Help 1]
 [ERROR] 
 [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.

diff --git a/docs/versions/latest/General/Cheatsheets/cs-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/cs-plugin-arguments.md
@@ -1,7 +1,7 @@
 [ERROR] 
 [ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
 [ERROR] artifactId: 'cs-package-maven-plugin'
-[ERROR] version: '2.43.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:cs-package-maven-plugin:2.43.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:cs-package-maven-plugin:jar:2.43.1-SNAPSHOT
+[ERROR] version: '2.44.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:cs-package-maven-plugin:2.44.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:cs-package-maven-plugin:jar:2.44.1-SNAPSHOT
 [ERROR] -> [Help 1]
 [ERROR] 
 [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.

diff --git a/docs/versions/latest/General/Cheatsheets/polyglot-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/polyglot-plugin-arguments.md
@@ -1,7 +1,7 @@
 [ERROR] 
 [ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
 [ERROR] artifactId: 'o11n-polyglot-package-maven-plugin'
-[ERROR] version: '2.43.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-polyglot-package-maven-plugin:2.43.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:o11n-polyglot-package-maven-plugin:jar:2.43.1-SNAPSHOT
+[ERROR] version: '2.44.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-polyglot-package-maven-plugin:2.44.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:o11n-polyglot-package-maven-plugin:jar:2.44.1-SNAPSHOT
 [ERROR] -> [Help 1]
 [ERROR] 
 [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.

diff --git a/docs/versions/latest/General/Cheatsheets/ssh-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/ssh-plugin-arguments.md
@@ -1,7 +1,7 @@
 [ERROR] 
 [ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
 [ERROR] artifactId: 'ssh-maven-plugin'
-[ERROR] version: '2.43.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:ssh-maven-plugin:2.43.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:ssh-maven-plugin:jar:2.43.1-SNAPSHOT
+[ERROR] version: '2.44.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:ssh-maven-plugin:2.44.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:ssh-maven-plugin:jar:2.44.1-SNAPSHOT
 [ERROR] -> [Help 1]
 [ERROR] 
 [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.

diff --git a/docs/versions/latest/General/Cheatsheets/typescript-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/typescript-plugin-arguments.md
@@ -1,7 +1,7 @@
 [ERROR] 
 [ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
 [ERROR] artifactId: 'o11n-typescript-package-maven-plugin'
-[ERROR] version: '2.43.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-typescript-package-maven-plugin:2.43.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:o11n-typescript-package-maven-plugin:jar:2.43.1-SNAPSHOT
+[ERROR] version: '2.44.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-typescript-package-maven-plugin:2.44.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:o11n-typescript-package-maven-plugin:jar:2.44.1-SNAPSHOT
 [ERROR] -> [Help 1]
 [ERROR] 
 [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.

diff --git a/docs/versions/latest/General/Cheatsheets/vcd-ng-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/vcd-ng-plugin-arguments.md
@@ -1,7 +1,7 @@
 [ERROR] 
 [ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
 [ERROR] artifactId: 'vcd-ng-package-maven-plugin'
-[ERROR] version: '2.43.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vcd-ng-package-maven-plugin:2.43.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:vcd-ng-package-maven-plugin:jar:2.43.1-SNAPSHOT
+[ERROR] version: '2.44.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vcd-ng-package-maven-plugin:2.44.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:vcd-ng-package-maven-plugin:jar:2.44.1-SNAPSHOT
 [ERROR] -> [Help 1]
 [ERROR] 
 [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.

diff --git a/docs/versions/latest/General/Cheatsheets/vra-ng-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/vra-ng-plugin-arguments.md
@@ -1,7 +1,7 @@
 [ERROR] 
 [ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
 [ERROR] artifactId: 'vra-ng-package-maven-plugin'
-[ERROR] version: '2.43.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vra-ng-package-maven-plugin:2.43.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:vra-ng-package-maven-plugin:jar:2.43.1-SNAPSHOT
+[ERROR] version: '2.44.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vra-ng-package-maven-plugin:2.44.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:vra-ng-package-maven-plugin:jar:2.44.1-SNAPSHOT
 [ERROR] -> [Help 1]
 [ERROR] 
 [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.

diff --git a/docs/versions/latest/General/Cheatsheets/vrealize-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/vrealize-plugin-arguments.md
@@ -1,7 +1,7 @@
 [ERROR] 
 [ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
 [ERROR] artifactId: 'vrealize-package-maven-plugin'
-[ERROR] version: '2.43.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vrealize-package-maven-plugin:2.43.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:vrealize-package-maven-plugin:jar:2.43.1-SNAPSHOT
+[ERROR] version: '2.44.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vrealize-package-maven-plugin:2.44.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:vrealize-package-maven-plugin:jar:2.44.1-SNAPSHOT
 [ERROR] -> [Help 1]
 [ERROR] 
 [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.

diff --git a/docs/versions/latest/General/Cheatsheets/vrli-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/vrli-plugin-arguments.md
@@ -1,7 +1,7 @@
 [ERROR] 
 [ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
 [ERROR] artifactId: 'vrli-package-maven-plugin'
-[ERROR] version: '2.43.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vrli-package-maven-plugin:2.43.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:vrli-package-maven-plugin:jar:2.43.1-SNAPSHOT
+[ERROR] version: '2.44.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vrli-package-maven-plugin:2.44.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:vrli-package-maven-plugin:jar:2.44.1-SNAPSHOT
 [ERROR] -> [Help 1]
 [ERROR] 
 [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.

diff --git a/docs/versions/latest/General/Cheatsheets/vrops-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/vrops-plugin-arguments.md
@@ -1,7 +1,7 @@
 [ERROR] 
 [ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
 [ERROR] artifactId: 'vrops-package-maven-plugin'
-[ERROR] version: '2.43.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vrops-package-maven-plugin:2.43.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:vrops-package-maven-plugin:jar:2.43.1-SNAPSHOT
+[ERROR] version: '2.44.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:vrops-package-maven-plugin:2.44.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:vrops-package-maven-plugin:jar:2.44.1-SNAPSHOT
 [ERROR] -> [Help 1]
 [ERROR] 
 [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.

diff --git a/docs/versions/latest/General/Cheatsheets/xml-plugin-arguments.md b/docs/versions/latest/General/Cheatsheets/xml-plugin-arguments.md
@@ -1,7 +1,7 @@
 [ERROR] 
 [ERROR] groupId: 'com.vmware.pscoe.maven.plugins'
 [ERROR] artifactId: 'o11n-xml-package-maven-plugin'
-[ERROR] version: '2.43.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-xml-package-maven-plugin:2.43.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:o11n-xml-package-maven-plugin:jar:2.43.1-SNAPSHOT
+[ERROR] version: '2.44.1-SNAPSHOT': Plugin com.vmware.pscoe.maven.plugins:o11n-xml-package-maven-plugin:2.44.1-SNAPSHOT or one of its dependencies could not be resolved: Could not find artifact com.vmware.pscoe.maven.plugins:o11n-xml-package-maven-plugin:jar:2.44.1-SNAPSHOT
 [ERROR] -> [Help 1]
 [ERROR] 
 [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.

diff --git a/docs/versions/latest/Release.md b/docs/versions/latest/Release.md
@@ -10,83 +10,12 @@
 [//]: # (Describe the breaking change AND explain how to resolve it)
 [//]: # (You can utilize internal links /e.g. link to the upgrade procedure, link to the improvement|deprecation that introduced this/)
 
-### *`vrang.project.id` has been removed in favor of `vrang.project.name`*
-
-Moving forward, `vrang.project.id` will not be accepted as part of the configuration. Instead, use `vrang.project.name`.
-
-`project.name` is more flexible as it will automatically find out the `project.id`.
-
-### *`vrang.org.id` has been removed in favor of `vrang.org.name`*
-
-Moving forward, `vrang.org.id` will not be accepted as part of the configuration. Instead, use `vrang.org.name`.
-
-`org.name` is more flexible as it will automatically find out the `org.id`.
-
-### *Polyglot projects will not try to fix mistakes due to issues with the manifest*
-
-Before, the `polyglot.json` could be defined like this:
-
-```json5
-{
-  "platform": {
-    "runtime": "nodejs", // Here, this makes sense only for `ABX` projects, but not `vro` ones, which this is, looking 5 rows down
-    "action": "auto",  
-    "tags": [],
-    "entrypoint": "out/handler.handler"
-  },
-  "vro": {
-    "module": "com.vmware.pscoe.templates.buildtoolsforvmwareariasamples",
-    "inputs": {
-      "limit": "number",
-      "vraEndpoint": "CompositeType(host:string,base:string):VraEndpointType"
-    },
-    "outputType": "Array/string"
-  },
-  "files": ["%out", "!**/package.json", "!**/polyglot.json", "!**/tsconfig.json"]
-}
-```
-That would result the build tools to compile this correctly and default to using `node:12`.
-
-Now, however, you have to define the `runtime` correctly as `node:12` if you want this to work.
-
-This applies for automatic fixes for `vro` and `abx` types.
-
-### *Policy Templates's `templateVersion` is now mandatory*
-
-`@PolicyTemplate` decorators now **must** specify a `templateVersion`.
-
-The possible options are `v1` and `v2` (you can also see this in the definitions).
-
-```ts
-@PolicyTemplate({
-  name: "Sample Policy",
-  path: "MyOrg/MyProject",
-  templateVersion: "v2", // This is now mandatory
-  variables: { /* ... */ },
-  elements: { /* ... */}
-})
-```
-
 ## Deprecations
 
 [//]: # (### *Deprecation*)
 [//]: # (Explain what is deprecated and suggest alternatives)
 
-### *Deprecation of vRA 7 archetype*
-
-The vRA 7 Archetype and all related plugins/mojos/code are removed due to the fact that vRA 7 is Out Of Support.
-
-The suggested alternative is to use version 2.44.0 of the toolchain. That is the last version that supports vRA7
-
-### *Deprecation of vRA 7 types*
-
-The `o11n-plugin-vcac` and `o11n-plugin-vcacafe` types are also removed.
-
-### *Deprecated Regional Content*
-
-The Regional content supported in previous versions of Build Tools for Aria has been removed. Unfortunately that part of the build tools never functioned the way we wanted it to, and managing the "infrastructure" tab in Assembler is no longer something we want to do as it contradicts the principles behind the `vra-ng` archetype.
-
-As an alternative, we suggest you use some sort of install workflow to manage them.
+[//]: # (Features -> New Functionality)
 
 ## Features
 
@@ -95,32 +24,10 @@ As an alternative, we suggest you use some sort of install workflow to manage th
 [//]: # (Optional But higlhy recommended Specify *NONE* if missing)
 [//]: # (#### Relevant Documentation:)
 
-### *Added a health check script*
-
-To check if the dependencies are met, you can now run:
-
-```sh
-curl -o- https://raw.githubusercontent.com/vmware/build-tools-for-vmware-aria/main/health.sh | bash
-```
-
-Works for Linux,Mac and Windows with Git Bash
-
 [//]: # (Improvements -> Bugfixes/hotfixes or general improvements)
 
-
 ## Improvements
 
-### *Flexible unit tests setup*
-It is now possible to configure how the unit tests are being bootstrapped and executed.
-#### Previous Behavior
-Unit tests were locked to a specific version of Jasmine.
-#### New Behavior
-There are two out-of-the-box options for test frameworks: Jasmine and Jest.  
-The default behavior will be fully backwards compatible. Optionally the user is able to specify which
-framework should be used as well as its version or even completely override how the unit tests are being ran.
-#### Relevant Documentation
-More in-depth documentation is available in the [vrotest](./../../../typescript/vrotest/) component.
-
 [//]: # (### *Improvement Name* )
 [//]: # (Talk ONLY regarding the improvement)
 [//]: # (Optional But higlhy recommended)
@@ -134,40 +41,4 @@ More in-depth documentation is available in the [vrotest](./../../../typescript/
 
 ## Upgrade procedure
 
-### *Polyglot projects using `nodejs` as a runtime for a `vro` project need to be migrated*
-
-1. Look for all of your polyglot projects made for `vro`.
-2. Look for `nodejs` runtimes and change them to `node:12`.
-3. Look for `powershell` runtimes and change them to `powercli:11-powershell-6.2`
-4. Look for `python` runtimes and change them to `python:3.7`
-
-Note:
-
-You don't need to migrate projects if they are `abx` based. `nodejs` is the correct value for `abx` projects.
-
-### *Polyglot projects using vro runtimes for abx projects need to be migrated*
-
-1. Take a look at the documentation for the available runtimes
-2. Correctly set the `vro` runtime you want to use instead of the `abx`
-3. `nodejs`, `powershell` or `python` only
-
-### *Migrate PolicyTemplates*
-
-Search your projects that use `@PolicyTemplate` decorator. The `templateVersion` property is now required. Check on top for possible values
-
-### *Migrate away from `vrang.project.id`*
-
-1. Open your `settings.xml`.
-2. Search for `vrang.project.id`.
-3. If found, replace it with the name of the project as seen in Aria
-
-### *Migrate away from `vrang.org.id`*
-
-1. Open your `settings.xml`.
-2. Search for `vrang.org.id`.
-3. If found, replace it with the name of the organization as seen in Aria
-
-### *Modify your `environment.properties` files if in use (installer)*
-
-1. If you have `environment.properties` that rely on `vrang_project_id`, they should be modified to use the `vrang_project_name`
-2. If you have `environment.properties` that rely on `vrang_org_id`, they should be modified to use the `vrang_org_name`
+[//]: # (Explain in details if something needs to be done)
diff --git a/docs/versions/v3.0.0/Components/Archetypes/General/Goals/Vrealize Clean.md b/docs/versions/v3.0.0/Components/Archetypes/General/Goals/Vrealize Clean.md
@@ -0,0 +1,36 @@
+# Vrealize Clean
+
+`vrealize:clean` is a goal used to clean up archetype packages on a given environment.
+
+## Overview
+
+`vrealize:clean` gives us a lot of flexibility in what is going to be deleted. You can find more about the different options in the sections below.
+
+## Table Of Contents
+
+1. [Archetype Support for vrealize:clean](#archetype-support-for-vrealizeclean)
+2. [Usage](#usage)
+
+### Archetype Support for vrealize:clean
+
+| Archetype | Supported | Comment                                                            |
+|-----------|-----------|--------------------------------------------------------------------|
+| vra       | Yes       | -                                                                  |
+| vro       | Yes       | -                                                                  |
+| vcd       | Partial   | It does not support dryRunning                                     |
+| abx       | No        | Not implemented                                                    |
+| vrops     | No        | Not implemented                                                    |
+| vra-ng    | Partial   | Does not support dryRunning and does not work for regional content |
+| vrli      | No        | vRLI does not provide native package support                       |
+| cs        | No        | Code Stream Services does not provide native support for packages  |
+
+### Usage
+
+```bash
+mvn vrealize:clean -DincludeDependencies=true -DcleanUpOldVersions=true -DcleanUpLastVersion=false -Ddryrun=true -P${PROFILE}
+```
+
+- includeDependencies - a flag depicting if dependencies should also be deleted
+- cleanUpOldVersions - a flag depicting if old versions of the package (and dependencies in case of includeDependencies) should be deleted
+- cleanUpLastVersion - a flag depicting if the latest version should also be deleted before importing
+- dryrun - Dryrun or not
diff --git a/docs/versions/v3.0.0/Components/Archetypes/Polyglot/General/New Project.md b/docs/versions/v3.0.0/Components/Archetypes/Polyglot/General/New Project.md
@@ -0,0 +1,32 @@
+# New Project
+
+## Table Of Contents
+
+- [Generate A New Project](#generate-a-new-project)
+
+### Generate A New Project
+
+- Replace `archetypeVersion` with the latest toolchain version
+- Specify `type` to be either `abx` (vRA ABX Actions) or `vro` (vRO Polyglot Actions).
+
+```bash
+#vRO:  
+mvn archetype:generate \ 
+  -DinteractiveMode=false \
+  -DarchetypeGroupId=com.vmware.pscoe.polyglot.archetypes \
+  -DarchetypeArtifactId=package-polyglot-archetype \
+  -DarchetypeVersion={LATEST_VERSION} \ 
+  -DgroupId=com.vmware.pscoe \
+  -DartifactId=testvronew \
+  -Dtype=vro  
+
+#ABX:  
+mvn archetype:generate \
+  -DinteractiveMode=false \
+  -DarchetypeGroupId=com.vmware.pscoe.polyglot.archetypes \
+  -DarchetypeArtifactId=package-polyglot-archetype \
+  -DarchetypeVersion={LATEST_VERSION} \
+  -DgroupId=com.vmware.pscoe \
+  -DartifactId=testabxnew \
+  -Dtype=abx
+```