Better documentation and explanation of object shapes

[ghostsquad]

An example is: https://github.com/jsonnet-libs/k8s-libsonnet/blob/main/docs/1.26/core/v1/service.md#fn-new

what is selector or ports supposed to look like?

Might be nice to include links back to the api reference documentation, e.g. https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#servicespec-v1-core