Hint about using "kubectl explain" inside samples

Author: antoineco

config/samples/httppollersource.yaml

@@ -13,31 +13,26 @@
 # limitations under the License.
 
 # Sample HTTPPollerSource object.
+#
+# For a list and description of all available attributes, execute the following command against a cluster where this
+# Custom Resource Definition has been registered:
+#
+#   kubectl explain httppollersources.sources.triggermesh.io
 
 apiVersion: sources.triggermesh.io/v1alpha1
 kind: HTTPPollerSource
 metadata:
-  name: httppoller-test
+  name: sample
 spec:
   eventType: weather.alerts/kansas
   eventSource: gov.weather
+
   endpoint: https://api.weather.gov/alerts/active?area=KS
   method: GET
   interval: 20s
+
   sink:
     ref:
-      apiVersion: serving.knative.dev/v1
-      kind: Service
-      name: event-display
-
----
-
-apiVersion: serving.knative.dev/v1
-kind: Service
-metadata:
-  name: event-display
-spec:
-  template:
-    spec:
-      containers:
-      - image: gcr.io/knative-releases/knative.dev/eventing-contrib/cmd/event_display
+      apiVersion: eventing.knative.dev/v1
+      kind: Broker
+      name: default

config/samples/slacksource.yaml

@@ -13,31 +13,26 @@
 # limitations under the License.
 
 # Sample SlackSource object.
+#
+# For a list and description of all available attributes, execute the following command against a cluster where this
+# Custom Resource Definition has been registered:
+#
+#   kubectl explain slacksources.sources.triggermesh.io
 
 apiVersion: sources.triggermesh.io/v1alpha1
 kind: SlackSource
 metadata:
-  name: triggermesh-knbot
+  name: sample
 spec:
   # optional, making sure we are receiving events on behalf of Slack
   signingSecret:
     value: XXXXXXXXXXXXXXXXXX
+
   # optional, making sure the events are being sent for this integration
   appID: AXXXXXXXXX
+
   sink:
     ref:
-      apiVersion: serving.knative.dev/v1
-      kind: Service
-      name: event-display
-
----
-
-apiVersion: serving.knative.dev/v1
-kind: Service
-metadata:
-  name: event-display
-spec:
-  template:
-    spec:
-      containers:
-      - image: gcr.io/knative-releases/knative.dev/eventing-contrib/cmd/event_display
+      apiVersion: eventing.knative.dev/v1
+      kind: Broker
+      name: default

config/samples/webhooksource.yaml

@@ -13,31 +13,26 @@
 # limitations under the License.
 
 # Sample WebhookSource object.
+#
+# For a list and description of all available attributes, execute the following command against a cluster where this
+# Custom Resource Definition has been registered:
+#
+#   kubectl explain webhooksources.sources.triggermesh.io
 
 apiVersion: sources.triggermesh.io/v1alpha1
 kind: WebhookSource
 metadata:
-  name: webhooksource-test
+  name: sample
 spec:
   eventType: com.example.mysample.event
   eventSource: instance-abc123
+
   basicAuthUsername: customuser
   basicAuthPassword:
     value: abc123secret
+
   sink:
     ref:
-      apiVersion: serving.knative.dev/v1
-      kind: Service
-      name: event-display
-
----
-
-apiVersion: serving.knative.dev/v1
-kind: Service
-metadata:
-  name: event-display
-spec:
-  template:
-    spec:
-      containers:
-      - image: gcr.io/knative-releases/knative.dev/eventing-contrib/cmd/event_display
+      apiVersion: eventing.knative.dev/v1
+      kind: Broker
+      name: default

config/samples/zendesksource.yaml

@@ -13,33 +13,30 @@
 # limitations under the License.
 
 # Sample ZendeskSource object.
+#
+# For a list and description of all available attributes, execute the following command against a cluster where this
+# Custom Resource Definition has been registered:
+#
+#   kubectl explain zendesksources.sources.triggermesh.io
 
 apiVersion: sources.triggermesh.io/v1alpha1
 kind: ZendeskSource
 metadata:
-  name: zendesksource
+  name: sample
 spec:
-  email: johndoe@example.com
+
   subdomain: example-corp
+
+  email: johndoe@example.com
   token:
     value: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+
   webhookUsername: foo
   webhookPassword:
     value: secret1234
+
   sink:
     ref:
-      apiVersion: serving.knative.dev/v1
-      kind: Service
-      name: event-display
-
----
-
-apiVersion: serving.knative.dev/v1
-kind: Service
-metadata:
-  name: event-display
-spec:
-  template:
-    spec:
-      containers:
-      - image: gcr.io/knative-releases/knative.dev/eventing-contrib/cmd/event_display
+      apiVersion: eventing.knative.dev/v1
+      kind: Broker
+      name: default