Relocate event source docs (knative#3948)

* Update links

* Update nav.yaml for event source move

* fix another link

* Move event source files to developer guide

* Move event samples to samples folder

* Move event samples to samples folder

* link fixes and improvements

* tweak some more links

* Update redirects

* Rebase redirects

* fixing infinite redirect bug

* Move creating event sources

Co-authored-by: Omer B <[email protected]>

blog/articles/event-driven-image-bigquery-processing-pipelines.md

@@ -20,7 +20,7 @@ instructions, as part of my [Knative Tutorial](https://github.com/meteatamel/kna
 When creating these example pipelines, I relied on a few Knative components that greatly simplified
 my development. More specifially:
 
-1. [Event sources](https://knative.dev/docs/eventing/sources/) allow you to
+1. [Event sources](https://knative.dev/docs/developer/eventing/sources/) allow you to
    read external events in your cluster. [Knative-GCP
    Sources](https://github.com/google/knative-gcp#knative-gcp-sources) provide a
    number of eventing sources ready to read events from various Google Cloud

blog/releases/announcing-knative-v0-3-release.html

@@ -47,7 +47,7 @@ <h3 name="4108" id="4108" class="graf graf--h3 graf-after--p">Networking</h3>
             <p name="7ce7" id="7ce7" class="graf graf--p graf-after--h3">A frequently-requested feature is the ability to deploy services which are not exposed externally and can only be accessed by other services in the cluster. In v0.3, Routes <a href="../../../../../docs/reference/serving-api/#RouteStatus">configured</a> to use the `svc.cluster.local` domain will only be exposed to the cluster-local Istio gateway. The cluster-local gateway will keep the deployed service inaccessible from outside the cluster. Developers can also use the `serving.knative.dev/visibility=cluster-local` label on their Route or Service to enable this behaviour.</p>
             <p name="09bc" id="09bc" class="graf graf--p graf-after--p">Knative is also deprecating its dedicated Istio gateway. In v0.3 release, Knative will still expose public routes to both the deprecated gateway and the default Istio gateway. Starting with next release however, Knative will remove the deprecated gateway to further reduce overhead and avoid the additional cost of public IP. (Note, you may have to update the gateway IP in your DNS mappings).</p>
             <h3 name="d066" id="d066" class="graf graf--h3 graf-after--p">Eventing</h3>
-            <p name="7ef7" id="7ef7" class="graf graf--p graf-after--h3">With the inclusion of Eventing in the previous release, there has been a significant focus on extending the number of and documenting available external event sources which can be installed in Knative as Kubernetes Custom Resource Definitions (CRDs). The complete list of currently supported event sources can be found <a href="../../../../../docs/eventing/sources#sources">here</a>.</p>
+            <p name="7ef7" id="7ef7" class="graf graf--p graf-after--h3">With the inclusion of Eventing in the previous release, there has been a significant focus on extending the number of and documenting available external event sources which can be installed in Knative as Kubernetes Custom Resource Definitions (CRDs). The complete list of currently supported event sources can be found <a href="../../../../../docs/developer/eventing/sources#sources">here</a>.</p>
             <h3 name="87ba" id="87ba" class="graf graf--h3 graf-after--p">Build</h3>
             <p name="9e6a" id="9e6a" class="graf graf--p graf-after--h3">The Knative Build component can now support both single `source` and multiple input `sources`. If multiple sources are requested, each will be fetched in declared order and placed into a directory under `/workspace` named after the source’s name field. The Build controller is also now subject to the PodSecurityPolicy which enables cluster operators to specify further limitations.</p>
             <h3 name="6e57" id="6e57" class="graf graf--h3 graf-after--p">Monitoring</h3>

config/nav.yml

@@ -72,13 +72,33 @@ nav:
             - Debugging application issues: developer/serving/troubleshooting/debugging-application-issues.md
         - Knative Eventing:
           - Event sources:
+            - Overview: developer/eventing/sources/README.md
+            - Creating an event source:
+              - Overview: developer/eventing/sources/creating-event-sources/README.md
+              - Writing an event source using Javascript: developer/eventing/sources/creating-event-sources/writing-event-source-easy-way/README.md
+              - Using the sample event source:
+                - Overview: developer/eventing/sources/creating-event-sources/writing-event-source/README.md
+                - Design of an Event Source: developer/eventing/sources/creating-event-sources/writing-event-source/01-theory.md
+                - Lifecycle and Types: developer/eventing/sources/creating-event-sources/writing-event-source/02-lifecycle-and-types.md
+                - Controller Implemetation: developer/eventing/sources/creating-event-sources/writing-event-source/03-controller.md
+                - Reconciler Implementation: developer/eventing/sources/creating-event-sources/writing-event-source/04-reconciler.md
+                - Receive Adapter Implementation: developer/eventing/sources/creating-event-sources/writing-event-source/05-receive-adapter.md
+                - Publishing to your cluster: developer/eventing/sources/creating-event-sources/writing-event-source/06-yaml.md
+                - Moving to knative-sandbox: developer/eventing/sources/creating-event-sources/writing-event-source/07-knative-sandbox.md
             - ApiServerSource:
               - Overview: developer/eventing/sources/apiserversource/README.md
               - Creating an ApiServerSource object: developer/eventing/sources/apiserversource/getting-started/README.md
               - ApiServerSource reference: developer/eventing/sources/apiserversource/reference.md
+            - Camel source: developer/eventing/sources/apache-camel-source/README.md
             - ContainerSource:
               - Creating a ContainerSource object: developer/eventing/sources/containersource/README.md
               - ContainerSource Reference: developer/eventing/sources/containersource/reference.md
+            - Kafka source: developer/eventing/sources/kafka-source/README.md
+            - PingSource: developer/eventing/sources/ping-source/README.md
+            - SinkBinding:
+              - Overview: developer/eventing/sources/sinkbinding/README.md
+              - Creating a SinkBinding object: developer/eventing/sources/sinkbinding/getting-started.md
+              - SinkBinding reference: developer/eventing/sources/sinkbinding/reference.md
           - Event delivery: developer/eventing/event-delivery.md
           - Event sinks:
             - About sinks: developer/eventing/sinks/README.md
@@ -156,27 +176,6 @@ nav:
     - Knative Eventing:
       - Overview: eventing/README.md
       - Getting started: eventing/getting-started.md
-      - Event sources:
-        - Overview: eventing/sources/README.md
-        - PingSource: eventing/sources/ping-source/README.md
-        - SinkBinding:
-          - Overview: eventing/sources/sinkbinding/README.md
-          - Creating a SinkBinding object: eventing/sources/sinkbinding/getting-started.md
-          - SinkBinding reference: eventing/sources/sinkbinding/reference.md
-        - Camel source: eventing/sources/apache-camel-source/README.md
-        - Kafka source: eventing/sources/kafka-source/README.md
-      - Creating an event source:
-        - Overview: eventing/sources/creating-event-sources/README.md
-        - Writing an event source using Javascript: eventing/sources/creating-event-sources/writing-event-source-easy-way/README.md
-        - Using the sample event source:
-          - Overview: eventing/sources/creating-event-sources/writing-event-source/README.md
-          - Design of an Event Source: eventing/sources/creating-event-sources/writing-event-source/01-theory.md
-          - Lifecycle and Types: eventing/sources/creating-event-sources/writing-event-source/02-lifecycle-and-types.md
-          - Controller Implemetation: eventing/sources/creating-event-sources/writing-event-source/03-controller.md
-          - Reconciler Implementation: eventing/sources/creating-event-sources/writing-event-source/04-reconciler.md
-          - Receive Adapter Implementation: eventing/sources/creating-event-sources/writing-event-source/05-receive-adapter.md
-          - Publishing to your cluster: eventing/sources/creating-event-sources/writing-event-source/06-yaml.md
-          - Moving to knative-sandbox: eventing/sources/creating-event-sources/writing-event-source/07-knative-sandbox.md
       - Event registry: eventing/event-registry.md
       - Flows:
         - Overview: eventing/flows/README.md
@@ -206,7 +205,7 @@ nav:
       - Experimental Features: eventing/experimental-features.md
       - Code samples:
         - Overview: eventing/samples/README.md
-        - Container source: eventing/sources/container-source/README.md
+        - Container source: eventing/samples/container-source/README.md
         - Hello World:
           - Overview: eventing/samples/helloworld/README.md
           - GO: eventing/samples/helloworld/helloworld-go/README.md
@@ -219,12 +218,12 @@ nav:
           - Overview: eventing/samples/parallel/README.md
           - Multiple Cases: eventing/samples/parallel/multiple-branches/README.md
           - Mutual Exclusivity: eventing/samples/parallel/mutual-exclusivity/README.md
-        - CloudAuditLogsSource: eventing/sources/cloud-audit-logs-source/README.md
-        - CloudPubSubSource: eventing/sources/cloud-pubsub-source/README.md
-        - CloudSchedulerSource: eventing/sources/cloud-scheduler-source/README.md
-        - CloudStorageSource: eventing/sources/cloud-storage-source/README.md
-        - GitHub source: eventing/sources/github-source/README.md
-        - GitLab source: eventing/sources/gitlab-source/README.md
+        - CloudAuditLogsSource: eventing/samples/cloud-audit-logs-source/README.md
+        - CloudPubSubSource: eventing/samples/cloud-pubsub-source/README.md
+        - CloudSchedulerSource: eventing/samples/cloud-scheduler-source/README.md
+        - CloudStorageSource: eventing/samples/cloud-storage-source/README.md
+        - GitHub source: eventing/samples/github-source/README.md
+        - GitLab source: eventing/samples/gitlab-source/README.md
         - IoT core: eventing/samples/iot-core/README.md
     # Reference docs
     - Reference:

config/redirects.yml

@@ -10,36 +10,35 @@ plugins:
       eventing/broker/alternate/index.md: eventing/broker/README.md
       eventing/broker/broker-event-delivery.md: developer/eventing/event-delivery.md
       eventing/broker/configmaps/README.md: admin/eventing/broker-configuration.md
-      eventing/broker/kafka-broker/index.md: eventing/broker/kafka-broker/README.md
       eventing/broker/kafka-broker/kafka-configmap.md: admin/eventing/kafka-channel-configuration.md
       eventing/channels/default-channels/index.md: eventing/channels/README.md
       eventing/event-delivery.md: developer/eventing/event-delivery.md
       eventing/metrics.md: admin/collecting-metrics/eventing-metrics/metrics.md
       eventing/parallel.md: eventing/flows/parallel.md
-      eventing/samples/apache-camel-source/index.md: eventing/sources/apache-camel-source/README.md
-      eventing/samples/gcp-pubsub-source/README.md: eventing/sources/cloud-pubsub-source/README.md
-      eventing/samples/kubernetes-event-source/index.md: developer/eventing/sources/apiserversource/getting-started/README.md
-      eventing/samples/ping-source/index.md: eventing/sources/ping-source/README.md
+      eventing/samples/apache-camel-source/index.md: developer/eventing/sources/apache-camel-source/README.md
+      eventing/samples/gcp-pubsub-source/README.md: eventing/samples/cloud-pubsub-source/README.md
+      eventing/samples/kubernetes-event-source/index.md: developer/eventing/sources/apiserversource/README.md
+      eventing/samples/ping-source/index.md: developer/eventing/sources/ping-source/README.md
       eventing/samples/sequence/index.md: eventing/flows/sequence/README.md
       eventing/samples/sequence/sequence-replay-to-event-display/index.md: eventing/flows/sequence/sequence-reply-to-event-display/README.md
       eventing/samples/sequence/sequence-reply-to-sequence/index.md: eventing/flows/sequence/sequence-reply-to-sequence/README.md
       eventing/samples/sequence/sequence-terminal/index.md: eventing/flows/sequence/sequence-terminal/README.md
       eventing/samples/sequence/sequence-with-broker-trigger/index.md: eventing/flows/sequence/sequence-with-broker-trigger/README.md
-      eventing/samples/sinkbinding/README.md: eventing/sources/sinkbinding/README.md
-      eventing/samples/writing-event-source-easy-way/index.md: eventing/sources/creating-event-sources/writing-event-source-easy-way/README.md
-      eventing/samples/writing-event-source/01-theory/index.md: eventing/sources/creating-event-sources/writing-event-source/01-theory.md
-      eventing/samples/writing-event-source/02-lifecycle-and-types/index.md: eventing/sources/creating-event-sources/writing-event-source/02-lifecycle-and-types.md
-      eventing/samples/writing-event-source/03-controller/index.md: eventing/sources/creating-event-sources/writing-event-source/03-controller.md
-      eventing/samples/writing-event-source/04-reconciler/index.md: eventing/sources/creating-event-sources/writing-event-source/04-reconciler.md
-      eventing/samples/writing-event-source/05-receive-adapter/index.md: eventing/sources/creating-event-sources/writing-event-source/05-receive-adapter.md
-      eventing/samples/writing-event-source/06-yaml/index.md: eventing/sources/creating-event-sources/writing-event-source/06-yaml.md
-      eventing/samples/writing-event-source/07-knative-sandbox/index.md: eventing/sources/creating-event-sources/writing-event-source/07-knative-sandbox.md
-      eventing/samples/writing-event-source/index.md: eventing/sources/creating-event-sources/writing-event-source/README.md
+      eventing/samples/sinkbinding/README.md: developer/eventing/sources/sinkbinding/README.md
+      eventing/samples/writing-event-source-easy-way/index.md: developer/eventing/sources/creating-event-sources/writing-event-source-easy-way/README.md
+      eventing/samples/writing-event-source/01-theory/index.md: developer/eventing/sources/creating-event-sources/writing-event-source/01-theory.md
+      eventing/samples/writing-event-source/02-lifecycle-and-types/index.md: developer/eventing/sources/creating-event-sources/writing-event-source/02-lifecycle-and-types.md
+      eventing/samples/writing-event-source/03-controller/index.md: developer/eventing/sources/creating-event-sources/writing-event-source/03-controller.md
+      eventing/samples/writing-event-source/04-reconciler/index.md: developer/eventing/sources/creating-event-sources/writing-event-source/04-reconciler.md
+      eventing/samples/writing-event-source/05-receive-adapter/index.md: developer/eventing/sources/creating-event-sources/writing-event-source/05-receive-adapter.md
+      eventing/samples/writing-event-source/06-yaml/index.md: developer/eventing/sources/creating-event-sources/writing-event-source/06-yaml.md
+      eventing/samples/writing-event-source/07-knative-sandbox/index.md: developer/eventing/sources/creating-event-sources/writing-event-source/07-knative-sandbox.md
+      eventing/samples/writing-event-source/index.md: developer/eventing/sources/creating-event-sources/writing-event-source/README.md
       eventing/sequence.md: eventing/flows/sequence/README.md
       eventing/sink/README.md: developer/eventing/sinks/README.md
       eventing/sink/kafka-sink.md: developer/eventing/sinks/kafka-sink.md
       eventing/sources/apiserversource/index.md: developer/eventing/sources/apiserversource/README.md
-      eventing/sources/pingsource/index.md: eventing/sources/ping-source/README.md
+      eventing/sources/pingsource/index.md: developer/eventing/sources/ping-source/README.md
       eventing/sources/containersource.md: developer/eventing/sources/containersource/README.md
       eventing/triggers/index.md: eventing/broker/triggers/README.md
       help/README.md: help/contributor/README.md