closes #225 (#278)

Signed-off-by: Leonardo F <leonardofe@pm.me>

kubernetes/show/health-status/README.md

@@ -1,11 +1,51 @@
 # Kubernetes show health-status
 
-## command
+## Premisses
+
+- Set kubeconfig credentials (`rit set credentials`)
+
+## Command
+
+- Prompt
 
 ```bash
 rit kubernetes show health-status
 ```
 
-## description
+- Docker
+
+```bash
+rit kubernetes show health-status --docker
+```
+
+- Stdin
+
+```bash
+echo '{"namespace": "kube-system", "pod_part_name": "coredns"}' | rit kubernetes
+show health-status --stdin
+```
+
+- Stdin + docker
+
+```bash
+echo '{"namespace": "kube-system", "pod_part_name": "coredns"}' | rit kubernetes
+show health-status --stdin --docker
+```
+
+## Description
+
+This _health-status_ command checks if the container is running as expected.
+
+How does ritchie do it? The command will fetch the port which is configured in
+the livenessProbe of the container. If the container doesn't have it configured,
+the command will fail. If it does have it, ritchie will make a port forward from
+the container to your machine, and test if it can connect to it.
+
+The user has to inform 2 different kinds of inputs:
+
+- the namespace that the pod is running
+- the name of the pod (or at least a part of it)
+
+## Demonstration
 
-This formula check health status of kubernets
+[![asciicast](https://asciinema.org/a/365442.svg)](https://asciinema.org/a/365442)