🐛 Fix API documentation to comply with k8s conventions by fixing embedded field docs and adding missing +optional markers #4527