Poorly documented? Surely you jest, the K8s documentation is _excellent_.

For basically every core resource type, there’s a user-guide, examples, a tour of it, in-depth docs and then the api docs themselves.