Enhance documentation for basic install

[laurent-indermuehle]

SUMMARY

This PR add missing information about how to choose a release with Git in order for the make deploy to not fall inside the "Pull Image Backoff" state.

Also, the repo already contains a awx-demo.yml file but the doc reference awx-demo.yaml with en extra a. I remove this road block for newcomers by using same yml extension everywhere.

ISSUE TYPE

• Bug, Docs Fix or other nominal change

ADDITIONAL INFORMATION

[rooftopcellist]

@laurent-indermuehle Thank you for you PR! It looks like there is some confusion here though.

The make deploy install method and the kustomization.yml install method are two different ways to install the awx-operator. So you don't have to make a kustomization.yml file if you are using make deploy (thus "can" rather than "must").

I think we could make this clearer by splitting this up into two different markdown headers.

• Make Deploy Install
• Kustomize Install

Would you be open to updating your PR to reflect that?

[laurent-indermuehle]

@rooftopcellist thanks for your reply. I will test again tomorrow, but I'm pretty sure make deploy failed when kustomization.yml file is absent. My computer here refuse to load kvm-amd module for whatever reason so it as to wait until I get back to the office. Sorry for the delay.

[laurent-indermuehle]

@rooftopcellist sorry for the delay, something came up on Friday.
I took the time to read the makefile and modify my PR accordingly to what I understood.
I hope my explanation are clear enough.

[rooftopcellist]

It would be good to point out in a note that if they make changes to the role, they should build the image with the changes, push it to their registry, then specify the custom operator image. or, point them to the contributing guide.

[laurent-indermuehle]

Isn't lines 30-33 already implicitly explaining that @rooftopcellist?

If you have a custom operator image you have built, you can specify it with:

IMG=quay.io/$YOURNAMESPACE/awx-operator:$YOURTAG make deploy