Add docs are starting with the archetype

[ibacher]

No description provided.

[ibacher]

cc: @rbuisson

[kazlaw]

@ibacher the maven-archetype doesn't seem to be found when using the generate command. How should I set up my archetype repositories for it to be picked up?

[kazlaw]

I would suggest that archetype doesn't add the Ozone word to the distribution name as below.

[ibacher]

This is why I suggested using "Grunzinia" or, in this case, "Haiti". It seemed nicer to ask the user for the part that changes instead of requiring someone type "Ozone" everytime.

[rbuisson]

Not always.

When distributions don't have a proper product name, yes we should put Ozone in front. When they do, then they should be able to not have to have Ozone.
KenyaHMIS distro for instance is named KenyaHMIS not Ozone KenyaHMIS.
But for Haiti, well, we don't have a good product name for it, so it's just Ozone Haiti

distributionName: A user-friendly name for your distribution. For example, an Ozone implementation for the country of Gruzinia might use "Ozone Gruzinia" as the distribution name.

[ibacher]

How should I set up my archetype repositories for it to be picked up?

You need to have the standard OpenMRS Maven setup, so that the "archetype" server resolves to "https://mavenrepo.openmrs.org/public".

[rbuisson]

Regarding this

You need to have the standard OpenMRS Maven setup, so that the "archetype" server resolves to "https://mavenrepo.openmrs.org/public".

@ibacher , could you add this to the doc itself, as well as a link to the OpenMRS documentation to set that up?

[rbuisson]

Thanks @ibacher . I've made another PR that I could easily amend, which largely reuses your instructions.
#4
Closing this one.