I know pretty much zero about k8s, but was it really important to remove Swagger? Seems like relatively useful functionality and not a huge complexity point? I really like the idea of a simple opinionated K8s BTW good luck!
Just dead weight otherwise. You can always add it later if people really need it.
True, Swagger docs can be helpful, but also if present but rubbish ignored swagger docs with missing features or side effects is more confusing. Just talk.
You have to write your documentation in a real human language. Maybe I just don't get the point of swagger.