Fix yaml-syntax of k8s manifest files placed in terraform/files/kubernetes-manifests.d directory

Created by: matofeder

Github action check check-yaml-syntax validates all '.yaml' and '.yml' files in k8s-cluster-api-provider repository.

This check complains about the following (multiple times):

• [document-start] missing document start "---"
• [comments] missing starting space in comment

Visit some PR, identify places where a fix is needed, and provide the fix.