The command for creating a new project on Windows is incorrect in documentation

The command is shown on two different pages (that I found) and is wrong on both of them (more so on one than the other).

The first is on the Downloads page: https://developers.bloomreach.com/download

Here, the command is listed as:

mvn org.apache.maven.plugins:maven-archetype-plugin:2.4:generate -DarchetypeRepository=https://maven.onehippo.com/maven2-enterprise-DarchetypeGroupId=org.onehippo.cms7 -DarchetypeArtifactId=hippo-project-archetype -DarchetypeVersion=13.0.0-1

There are several problems with this:

  • There should be a space after the repository URL, before the - (dash) prefix of the DarchetypeGroupId argument
  • The maven2-enterprise repository is listed here even though this page is linked to from the “Try for free” button (bad user experience for those wanting to try the platform out) and the non-Windows command uses the maven2 repo
  • The value of each of the arguments should be enclosed in quotes to support Windows CMD and PowerShell
  • The version listed on that page, 13.0.0-1, is not the latest publicly available version as the page states

The command should be:

mvn org.apache.maven.plugins:maven-archetype-plugin:2.4:generate -DarchetypeRepository="https://maven.onehippo.com/maven2" -DarchetypeGroupId="org.onehippo.cms7" -DarchetypeArtifactId="hippo-project-archetype" -DarchetypeVersion="13.3.0"

The second page is the Creating a Project tutorial page: https://documentation.bloomreach.com/trails/getting-started/creating-a-project.html

This page does correctly separate the repository URL from the prefix of the subsequent argument, it correctly uses the maven2 repository URL, and it does use version 13.3.0. However, the values for the arguments still need to be wrapped in quotes to ensure support for Windows CMD and PowerShell.

Hi @zkniebel,

Welcome to the community and thanks so much for your feedback! It indeed looks like a few errors found their way onto the Downloads page. I will make sure to update these straight away.

Thanks again,
Niklas