docs: Add section on helpful tools

[yuvipanda]

This document can collect tools that are required to work
with the infrastructure deployed from this repo, and any
additional tips / resources that are specifically useful
to us. The hope is that this list grows over time as we gain
more experience.

Ref #476

[damianavila]

That is a good idea although I would keep kubectl in our docs when we showcase commands...

[yuvipanda]

Yeah, I agree!

[damianavila]

This is a great start!!
And I agree this is something to iterate on... so 👍 on merging early than later!

[sgibson91]

Love it! 💖 Also agree with @damianavila that this can be iterated upon and I think it's fine to merge as is and open new PRs as folk discover new things :)

[yuvipanda]

Pinging @consideRatio who probably knows a bunch of useful tools and tricks

[consideRatio]

Some tricks using the helm cli are...

• the --repo flag is nice, helps you do a single command to do something with a chart without using helm repo add etc. first.

  helm template --repo https://jupyterhub.github.io/helm-chart/ jupyterhub

• the --show-only flag is nice, helps you review a specific helm chart template instead of the entire chart.

  # example on how to access a specific template
  helm template --repo https://jupyterhub.github.io/helm-chart/ jupyterhub \
      --show-only templates/hub/deployment.yaml
  
  # example on how to access a specific template from a subchart
  # note we need to specify version, as there is no non-pre-release
  # version available
  helm template --repo https://jupyterhub.github.io/helm-chart/ binderhub \
      --version=0.2.0-n611.he777436 \
      --set jupyterhub.hub.services.binder.apiToken=asd \
      --show-only charts/jupyterhub/templates/hub/deployment.yaml

• the --validate flag with helm template will not only render the templates, but also send --dry-run requests to the configured k8s api-server to see if the k8s api-server would accept those rendered manifests. This is useful as helm template would render almost anything, even if its not valid k8s resources.

[damianavila]

Some tricks using the helm cli are...

A PR adding these tricks is more than welcome 😜 !

[consideRatio]

Thanks for the nudge @damianavila.

I'm relieved to see markdown based documentation instead of rST 😌 - I'm totally sold on the use of MyST for project documentation atm.

#499 opened