Docs: Feedback for Deploy a Cluster with the Hazelcast Platform Operator for Kubernetes

[avtarraikmo]

Hi, I have some feedback about this page

Instruction step 2, to install an operator fails if the cluster is not up and running at localhost:8080

Can we add instructions on how to get a K8s / Openshift cluster up and running too?

[hasancelik]

Hi @avtarraikmo,

As mentioned in the 'Overview' section:
This documentation assumes an intermediate knowledge of Kubernetes.

So we do not need to running k8s cluster as a pre-requisite or provide steps to make it. We should keep the page clean.

[avtarraikmo]

What does 'intermediate' knowledge mean?

How do I quantify that?

[hasancelik]

I am not sure that we should quantify that because it is just a term to inform/prepare the user about upcoming doc sections. Our assumption was when put this sentence is:

• Knowledge of k8s terms and basics, because they will be widely used in the doc
• Having basic toolset for k8s like kubectl,helm and running cluster.

BTW, we have already given some installation references at the operator tutorials:
https://docs.hazelcast.com/tutorials/hazelcast-platform-operator-expose-externally
maybe we can follow same approach for Getting Started section, I will discuss with documentation team how we can make our doc more instructive without converting it into tutorial 🙂