Fix edit page links, move technical docs under sub-heading (#6398)

* Fix edit links by moving docs content under a dedicated subdirectory

* Fix edit links by moving docs content under a dedicated subdirectory

config/redirects.yml

@@ -1,228 +1,228 @@
 plugins:
   redirects:
     redirect_maps:
-      docs/contributing/about.md: community/README.md
-      docs/eventing/experimental-features/README.md: docs/eventing/features/README.md
-      docs/eventing/experimental-features/delivery-timeout.md: docs/eventing/features/delivery-timeout.md
-      docs/eventing/experimental-features/delivery-retryafter.md: docs/eventing/features/delivery-retryafter.md
-      docs/eventing/experimental-features/new-trigger-filters.md: docs/eventing/triggers/README.md
-      docs/eventing/experimental-features/kreference-group.md: docs/eventing/features/kreference-group.md
-      docs/eventing/experimental-features/kreference-mapping.md: docs/eventing/features/kreference-mapping.md
-      docs/eventing/experimental-features/eventtype-auto-creation.md: docs/eventing/features/eventtype-auto-creation.md
-      docs/eventing/experimental-features/transport-encryption.md: docs/eventing/features/transport-encryption.md
-      docs/eventing/experimental-features/sender-identity.md: docs/eventing/features/sender-identity.md
-      docs/eventing/experimental-features/authorization.md: docs/eventing/features/authorization.md
-      docs/eventing/features/new-trigger-filters.md: docs/eventing/triggers/README.md
-      docs/eventing/broker/kafka-broker/kafka-configmap.md: docs/eventing/configuration/kafka-channel-configuration.md
-      docs/eventing/broker/create-mtbroker.md: docs/eventing/brokers/create-broker.md
-      docs/eventing/broker/example-mtbroker.md: docs/eventing/brokers/broker-developer-config-options.md
-      docs/eventing/broker/kafka-broker/README.md: docs/eventing/brokers/broker-types/kafka-broker/README.md
-      docs/eventing/broker/rabbitmq-broker/README.md: docs/eventing/brokers/broker-types/rabbitmq-broker/README.md
-      docs/eventing/broker/README.md: docs/eventing/brokers/README.md
-      docs/concepts/resources/revisions.md: docs/concepts/serving-resources/revisions.md
-      docs/serving/revision-gc.md: docs/serving/revisions/revision-developer-config-options.md
-      docs/serving/configuration/revision-gc.md: docs/serving/revisions/revision-admin-config-options.md
-      docs/reference/concepts/duck-typing.md: docs/concepts/duck-typing.md
-      docs/reference/client/README.md: docs/client/README.md
-      docs/reference/api/eventing-api.md: docs/eventing/reference/eventing-api.md
-      docs/reference/api/serving-api.md: docs/serving/reference/serving-api.md
-      docs/community/about.md: community/governance.md
-      docs/contributing/contributing.md: community/contributing.md
-      docs/contributing/README.md: community/README.md
-      docs/eventing/getting-started.md: docs/getting-started/getting-started-eventing.md
-      docs/admin/collecting-logs/README.md: docs/serving/observability/logging/collecting-logs.md
-      docs/admin/collecting-metrics/README.md: docs/serving/observability/metrics/collecting-metrics.md
-      docs/admin/collecting-metrics/eventing-metrics/metrics.md: docs/eventing/observability/metrics/eventing-metrics.md
-      docs/admin/collecting-metrics/serving-metrics/metrics.md: docs/serving/observability/metrics/serving-metrics.md
-      docs/admin/eventing/broker-configuration.md: docs/eventing/configuration/broker-configuration.md
-      docs/admin/eventing/channel-configuration.md: docs/eventing/configuration/channel-configuration.md
-      docs/admin/eventing/kafka-channel-configuration.md: docs/eventing/configuration/kafka-channel-configuration.md
-      docs/admin/eventing/sources-configuration.md: docs/eventing/configuration/sources-configuration.md
-      docs/admin/install/README.md: docs/install/README.md
-      docs/admin/install/eventing/eventing-installation-files.md: docs/install/yaml-install/eventing/eventing-installation-files.md
-      docs/admin/install/eventing/install-eventing-with-yaml.md: docs/install/yaml-install/eventing/install-eventing-with-yaml.md
-      docs/admin/install/install-eventing-with-yaml.md: docs/install/yaml-install/eventing/install-eventing-with-yaml.md
-      docs/admin/install/install-serving-with-yaml.md: docs/install/yaml-install/serving/install-serving-with-yaml.md
-      docs/admin/install/installing-istio.md: docs/install/installing-istio.md
-      docs/admin/install/knative-offerings.md: docs/install/knative-offerings.md
-      docs/admin/install/knative-with-operators.md: docs/install/operator/knative-with-operators.md
-      docs/admin/install/operator/configuring-eventing-cr.md: docs/install/operator/configuring-eventing-cr.md
-      docs/admin/install/operator/configuring-serving-cr.md: docs/install/operator/configuring-serving-cr.md
-      docs/admin/install/serving/install-serving-with-yaml.md: docs/install/yaml-install/serving/install-serving-with-yaml.md
-      docs/admin/install/serving/serving-installation-files.md: docs/install/yaml-install/serving/serving-installation-files.md
-      docs/admin/install/uninstall.md: docs/install/uninstall.md
-      docs/admin/serving/config-defaults.md: docs/serving/configuration/config-defaults.md
-      docs/admin/serving/deployment.md: docs/serving/configuration/deployment.md
-      docs/admin/serving/feature-flags.md: docs/serving/configuration/feature-flags.md
-      docs/admin/serving/rolling-out-latest-revision-configmap.md: docs/serving/configuration/rolling-out-latest-revision-configmap.md
-      docs/admin/upgrade/index.md: docs/install/upgrade/README.md
-      docs/admin/upgrade/upgrade-installation-with-operator.md: docs/install/upgrade/upgrade-installation-with-operator.md
-      docs/admin/upgrade/upgrade-installation.md: docs/install/upgrade/upgrade-installation.md
-      docs/check-install-version.md: docs/install/upgrade/check-install-version.md
-      docs/client/connecting-kn-to-your-cluster/index.md: docs/client/README.md
-      docs/community/annual_reports.md: https://github.com/knative/community/tree/main/annual_reports
-      docs/community/calendar.md: https://github.com/knative/community/blob/main/CALENDAR.MD
-      docs/community/contributing/code-of-conduct.md: https://github.com/knative/community/blob/main/CODE-OF-CONDUCT.md
-      docs/community/contributing/contributing.md: https://github.com/knative/community/blob/main/CONTRIBUTING.md
-      docs/community/contributing/governance.md: https://github.com/knative/community/blob/main/GOVERNANCE.md
-      docs/community/contributing/mechanics.md: https://github.com/knative/community/tree/main/mechanics
-      docs/community/contributing/mechanics/creating-an-extensions-repo.md: https://github.com/knative/community/blob/main/mechanics/CREATING-AN-EXTENSIONS-REPO.md
-      docs/community/contributing/mechanics/feature-tracks.md: https://github.com/knative/community/blob/main/mechanics/FEATURE-TRACKS.md
-      docs/community/contributing/mechanics/golang-policy.md: https://github.com/knative/community/blob/main/mechanics/GOLANG-POLICY.md
-      docs/community/contributing/mechanics/release-schedule.md: https://github.com/knative/community/blob/main/mechanics/RELEASE-SCHEDULE.md
-      docs/community/contributing/mechanics/release-versioning-principles.md: https://github.com/knative/community/blob/main/mechanics/RELEASE-VERSIONING-PRINCIPLES.md
-      docs/community/contributing/mechanics/sc.md: https://github.com/knative/community/blob/main/mechanics/SC.md
-      docs/community/contributing/mechanics/sunsetting-features.md: https://github.com/knative/community/blob/main/mechanics/SUNSETTING-FEATURES.md
-      docs/community/contributing/mechanics/toc.md: https://github.com/knative/community/blob/main/mechanics/TOC.md
-      docs/community/contributing/mechanics/working-group-processes.md: https://github.com/knative/community/blob/main/mechanics/WORKING-GROUP-PROCESSES.md
-      docs/community/contributing/repository-guidelines.md: https://github.com/knative/community/blob/main/REPOSITORY-GUIDELINES.md
-      docs/community/contributing/reviewing.md: https://github.com/knative/community/blob/main/REVIEWING.md
-      docs/community/contributing/roles.md: https://github.com/knative/community/blob/main/ROLES.md
-      docs/community/contributing/slack-guidelines.md: https://github.com/knative/community/blob/main/SLACK-GUIDELINES.md
-      docs/community/contributing/steering-committee.md: https://github.com/knative/community/blob/main/STEERING-COMMITTEE.md
-      docs/community/contributing/tech-oversight-committee.md: https://github.com/knative/community/blob/main/TECH-OVERSIGHT-COMMITTEE.md
-      docs/community/contributing/trademark-committee.md: https://github.com/knative/community/blob/main/TRADEMARK-COMMITTEE.md
-      docs/community/contributing/values.md: https://github.com/knative/community/blob/main/VALUES.md
-      docs/community/contributing/working-groups/working-groups.md: https://github.com/knative/community/blob/main/working-groups
-      docs/community/meetup.md: community/README.md
-      docs/community/samples.md: https://github.com/knative/docs/tree/main/code-samples/community
-      docs/concepts/overview.md: docs/index.md
-      docs/developer/concepts/duck-typing.md: docs/concepts/duck-typing.md
-      docs/developer/eventing/event-delivery.md: docs/eventing/event-delivery.md
-      docs/developer/eventing/sinks/README.md: docs/eventing/sinks/README.md
-      docs/developer/eventing/sinks/kafka-sink.md: docs/eventing/sinks/kafka-sink.md
-      docs/developer/eventing/sources/README.md: docs/eventing/sources/README.md
-      docs/developer/eventing/sources/apiserversource/README.md: docs/eventing/sources/apiserversource/README.md
-      docs/developer/eventing/sources/apiserversource/getting-started.md: docs/eventing/sources/apiserversource/getting-started.md
-      docs/developer/eventing/sources/apiserversource/reference.md: docs/eventing/sources/apiserversource/reference.md
-      docs/developer/eventing/sources/containersource/README.md: docs/eventing/custom-event-source/containersource/README.md
-      docs/developer/eventing/sources/containersource/reference.md: docs/eventing/custom-event-source/containersource/reference.md
-      docs/developer/eventing/sources/creating-event-sources/README.md: docs/eventing/custom-event-source/README.md
-      docs/developer/eventing/sources/creating-event-sources/writing-event-source/01-theory.md: docs/eventing/custom-event-source/custom-event-source/README.md
-      docs/developer/eventing/sources/creating-event-sources/writing-event-source/02-lifecycle-and-types.md: docs/eventing/custom-event-source/custom-event-source/controller.md
-      docs/developer/eventing/sources/creating-event-sources/writing-event-source/03-controller.md: docs/eventing/custom-event-source/custom-event-source/README.md
-      docs/developer/eventing/sources/creating-event-sources/writing-event-source/04-reconciler.md: docs/eventing/custom-event-source/custom-event-source/receive-adapter.md
-      docs/developer/eventing/sources/creating-event-sources/writing-event-source/05-receive-adapter.md: docs/eventing/custom-event-source/custom-event-source/receive-adapter.md
-      docs/developer/eventing/sources/creating-event-sources/writing-event-source/06-yaml.md: docs/eventing/custom-event-source/custom-event-source/publish-event-source.md
-      docs/developer/eventing/sources/creating-event-sources/writing-event-source/07-knative-extensions.md: docs/eventing/custom-event-source/custom-event-source/README.md
-      docs/developer/eventing/sources/creating-event-sources/writing-event-source/README.md: docs/eventing/custom-event-source/custom-event-source/README.md
-      docs/developer/eventing/sources/kafka-source/README.md: docs/eventing/sources/kafka-source/README.md
-      docs/developer/eventing/sources/ping-source/README.md: docs/eventing/sources/ping-source/README.md
-      docs/developer/eventing/sources/ping-source/reference.md: docs/eventing/sources/ping-source/reference.md
-      docs/developer/eventing/sources/sinkbinding/README.md: docs/eventing/custom-event-source/sinkbinding/README.md
-      docs/developer/eventing/sources/sinkbinding/getting-started.md: docs/eventing/custom-event-source/sinkbinding/create-a-sinkbinding.md
-      docs/developer/eventing/sources/sinkbinding/reference.md: docs/eventing/custom-event-source/sinkbinding/reference.md
-      docs/developer/serving/deploying-from-private-registry.md: docs/serving/deploying-from-private-registry.md
-      docs/developer/serving/rolling-out-latest-revision.md: docs/serving/rolling-out-latest-revision.md
-      docs/developer/serving/services/README.md: docs/serving/services/README.md
-      docs/developer/serving/services/byo-certificate.md: docs/serving/services/custom-tls-certificate-domain-mapping.md
-      docs/developer/serving/services/certificate-class.md: docs/serving/services/certificate-class.md
-      docs/developer/serving/services/configure-requests-limits-services.md: docs/serving/services/configure-requests-limits-services.md
-      docs/developer/serving/services/creating-services.md: docs/serving/services/creating-services.md
-      docs/developer/serving/services/custom-domains.md: docs/serving/services/custom-domains.md
-      docs/developer/serving/services/http-option.md: docs/serving/services/http-protocol.md
-      docs/developer/serving/services/ingress-class.md: docs/serving/services/ingress-class.md
-      docs/developer/serving/services/private-services.md: docs/serving/services/private-services.md
-      docs/developer/serving/services/service-metrics.md: docs/serving/observability/metrics/serving-metrics.md
-      docs/developer/serving/tag-resolution.md: docs/serving/tag-resolution.md
-      docs/developer/serving/traffic-management.md: docs/serving/traffic-management.md
-      docs/developer/serving/troubleshooting/debugging-application-issues.md: docs/serving/troubleshooting/debugging-application-issues.md
-      docs/eventing/broker/alternate/index.md: docs/eventing/brokers/README.md
-      docs/eventing/broker/broker-event-delivery.md: docs/eventing/event-delivery.md
-      docs/eventing/broker/configmaps/README.md: docs/eventing/configuration/broker-configuration.md
-      docs/eventing/channels/default-channels/index.md: docs/eventing/channels/README.md
-      docs/eventing/debugging/README.md: docs/eventing/troubleshooting/README.md
-      docs/eventing/metrics.md: docs/eventing/observability/metrics/eventing-metrics.md
-      docs/eventing/parallel.md: docs/eventing/flows/parallel.md
-      docs/eventing/samples/README.md: docs/samples/eventing.md
-      docs/eventing/samples/cloud-audit-logs-source/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/cloud-audit-logs-source
-      docs/eventing/samples/cloud-pubsub-source/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/cloud-pubsub-source
-      docs/eventing/samples/cloud-scheduler-source/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/cloud-scheduler-source
-      docs/eventing/samples/cloud-storage-source/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/cloud-storage-source
-      docs/eventing/samples/gcp-pubsub-source/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/cloud-pubsub-source
-      docs/eventing/samples/github-source/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/github-source
-      docs/eventing/samples/gitlab-source/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/gitlab-source
-      docs/eventing/samples/helloworld/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/helloworld
-      docs/eventing/samples/helloworld/helloworld-go/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/helloworld/helloworld-go
-      docs/eventing/samples/helloworld/helloworld-python/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/helloworld/helloworld-python
-      docs/eventing/samples/kafka/binding/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/kafka/binding
-      docs/eventing/samples/kafka/channel/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/kafka/channel
-      docs/eventing/samples/kubernetes-event-source/index.md: docs/eventing/sources/apiserversource/README.md
-      docs/eventing/samples/parallel/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/parallel
-      docs/eventing/samples/parallel/multiple-branches/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/parallel/multiple-branches
-      docs/eventing/samples/parallel/mutual-exclusivity/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/parallel/mutual-exclusivity
-      docs/eventing/samples/ping-source/index.md: docs/eventing/sources/ping-source/README.md
-      docs/eventing/samples/sequence/index.md: docs/eventing/flows/sequence/README.md
-      docs/eventing/samples/sequence/sequence-replay-to-event-display/index.md: docs/eventing/flows/sequence/sequence-reply-to-event-display/README.md
-      docs/eventing/samples/sequence/sequence-reply-to-sequence/index.md: docs/eventing/flows/sequence/sequence-reply-to-sequence/README.md
-      docs/eventing/samples/sequence/sequence-terminal/index.md: docs/eventing/flows/sequence/sequence-terminal/README.md
-      docs/eventing/samples/sequence/sequence-with-broker-trigger/index.md: docs/eventing/flows/sequence/sequence-with-broker-trigger/README.md
-      docs/eventing/samples/sinkbinding/README.md: docs/eventing/custom-event-source/sinkbinding/README.md
-      docs/eventing/samples/writing-event-source-easy-way/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/writing-event-source-easy-way
-      docs/eventing/sequence.md: docs/eventing/flows/sequence/README.md
-      docs/eventing/sink/README.md: docs/eventing/sinks/README.md
-      docs/eventing/sink/kafka-sink.md: docs/eventing/sinks/kafka-sink.md
-      docs/eventing/sources/containersource.md: docs/eventing/custom-event-source/containersource/README.md
-      docs/eventing/sources/pingsource/index.md: docs/eventing/sources/ping-source/README.md
-      docs/install/collecting-logs/index.md: docs/serving/observability/logging/collecting-logs.md
-      docs/install/collecting-metrics/index.md: docs/serving/observability/metrics/collecting-metrics.md
-      docs/install/eventing/eventing-installation-files.md: docs/install/yaml-install/eventing/eventing-installation-files.md
-      docs/install/eventing/install-eventing-with-yaml.md: docs/install/yaml-install/eventing/install-eventing-with-yaml.md
-      docs/install/getting-started-knative-app/index.md: docs/getting-started/README.md
-      docs/install/install-extensions.md: docs/install/README.md
-      docs/install/installation-files.md: docs/install/README.md
-      docs/install/prerequisites.md: docs/install/README.md
-      docs/install/serving/install-serving-with-yaml.md: docs/install/yaml-install/serving/install-serving-with-yaml.md
-      docs/install/serving/installing-cert-manager.md: docs/install/installing-cert-manager.md
-      docs/install/serving/installing-istio.md: docs/install/installing-istio.md
-      docs/install/serving/serving-installation-files.md: docs/install/yaml-install/serving/serving-installation-files.md
-      docs/operator/configuring-eventing-cr/index.md: docs/install/operator/configuring-eventing-cr.md
-      docs/operator/configuring-serving-cr/index.md: docs/install/operator/configuring-serving-cr.md
-      docs/reference/resources/index.md: docs/client/README.md
-      docs/serving/autoscaling/autoscaling-concepts.md: docs/serving/autoscaling/autoscaler-types.md
-      docs/serving/autoscaling/target-burst-capacity/index.md: docs/serving/load-balancing/target-burst-capacity.md
-      docs/serving/configuring-autoscaling/index.md: docs/serving/autoscaling/README.md
-      docs/serving/creating-domain-mappings.md: docs/serving/services/custom-domains.md
-      docs/serving/debugging-application-issues.md: docs/serving/troubleshooting/debugging-application-issues.md
-      docs/serving/feature-flags.md: docs/serving/configuration/feature-flags.md
-      docs/serving/getting-started-knative-app.md: docs/getting-started/README.md
-      docs/serving/installing-cert-manager.md: docs/install/installing-cert-manager.md
-      docs/serving/metrics.md: docs/serving/observability/metrics/serving-metrics.md
-      docs/serving/samples/README.md: docs/samples/serving.md
-      docs/serving/samples/autoscale-go/index.md: docs/serving/autoscaling/autoscale-go/README.md
-      docs/serving/samples/blue-green-deployment.md: docs/serving/traffic-management.md
-      docs/serving/samples/cloudevents/cloudevents-dotnet/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/cloudevents/cloudevents-dotnet
-      docs/serving/samples/cloudevents/cloudevents-go/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/cloudevents/cloudevents-go
-      docs/serving/samples/cloudevents/cloudevents-nodejs/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/cloudevents/cloudevents-nodejs
-      docs/serving/samples/cloudevents/cloudevents-rust/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/cloudevents/cloudevents-rust
-      docs/serving/samples/cloudevents/cloudevents-spring/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/cloudevents/cloudevents-spring
-      docs/serving/samples/cloudevents/cloudevents-vertx/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/cloudevents/cloudevents-vertx
-      docs/serving/samples/gitwebhook-go/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/gitwebhook-go
-      docs/serving/samples/grpc-ping-go/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/grpc-ping-go
-      docs/serving/samples/hello-world/helloworld-csharp/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/hello-world/helloworld-csharp
-      docs/serving/samples/hello-world/helloworld-go/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/hello-world/helloworld-go
-      docs/serving/samples/hello-world/helloworld-java-spark/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/hello-world/helloworld-java-spark
-      docs/serving/samples/hello-world/helloworld-java-spring/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/hello-world/helloworld-java-spring
-      docs/serving/samples/hello-world/helloworld-kotlin/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/hello-world/helloworld-kotlin
-      docs/serving/samples/hello-world/helloworld-nodejs/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/hello-world/helloworld-nodejs
-      docs/serving/samples/hello-world/helloworld-php/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/hello-world/helloworld-php
-      docs/serving/samples/hello-world/helloworld-python/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/hello-world/helloworld-python
-      docs/serving/samples/hello-world/helloworld-ruby/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/hello-world/helloworld-ruby
-      docs/serving/samples/hello-world/helloworld-scala/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/hello-world/helloworld-scala
-      docs/serving/samples/hello-world/helloworld-shell/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/hello-world/helloworld-shell
-      docs/serving/samples/knative-routing-go/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/knative-routing-go
-      docs/serving/samples/kong-routing-go/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/kong-routing-go
-      docs/serving/samples/multi-container/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/multicontainer
-      docs/serving/samples/secrets-go/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/secrets-go
-      docs/serving/samples/tag-header-based-routing/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/tag-header-based-routing
-      docs/serving/samples/traffic-splitting/README.md: docs/serving/traffic-management.md
-      docs/serving/services/deployment.md: docs/serving/configuration/deployment.md
-      docs/serving/services/http-option.md: docs/serving/services/http-protocol.md
-      docs/serving/services/service-metrics.md: docs/serving/observability/metrics/serving-metrics.md
-      docs/serving/spec/knative-api-specification-1.0.md: https://github.com/knative/specs/blob/main/specs/serving/knative-api-specification-1.0.md
-      docs/serving/using-an-ssl-cert/index.md: docs/serving/encryption/encryption-overview.md
-      docs/serving/encryption/enabling-automatic-tls-certificate-provisioning.md: docs/serving/encryption/encryption-overview.md
-      docs/serving/encryption/using-certificates-in-networking-layer.md: docs/serving/encryption/encryption-overview.md
-      docs/serving/using-subroutes.md: docs/serving/traffic-management.md
-      docs/eventing/brokers/create-mtbroker.md: docs/eventing/brokers/create-broker.md
-      docs/eventing/brokers/broker-admin-config-options.md: docs/eventing/configuration/broker-configuration.md
+      versioned/contributing/about.md: community/README.md
+      versioned/eventing/experimental-features/README.md: versioned/eventing/features/README.md
+      versioned/eventing/experimental-features/delivery-timeout.md: versioned/eventing/features/delivery-timeout.md
+      versioned/eventing/experimental-features/delivery-retryafter.md: versioned/eventing/features/delivery-retryafter.md
+      versioned/eventing/experimental-features/new-trigger-filters.md: versioned/eventing/triggers/README.md
+      versioned/eventing/experimental-features/kreference-group.md: versioned/eventing/features/kreference-group.md
+      versioned/eventing/experimental-features/kreference-mapping.md: versioned/eventing/features/kreference-mapping.md
+      versioned/eventing/experimental-features/eventtype-auto-creation.md: versioned/eventing/features/eventtype-auto-creation.md
+      versioned/eventing/experimental-features/transport-encryption.md: versioned/eventing/features/transport-encryption.md
+      versioned/eventing/experimental-features/sender-identity.md: versioned/eventing/features/sender-identity.md
+      versioned/eventing/experimental-features/authorization.md: versioned/eventing/features/authorization.md
+      versioned/eventing/features/new-trigger-filters.md: versioned/eventing/triggers/README.md
+      versioned/eventing/broker/kafka-broker/kafka-configmap.md: versioned/eventing/configuration/kafka-channel-configuration.md
+      versioned/eventing/broker/create-mtbroker.md: versioned/eventing/brokers/create-broker.md
+      versioned/eventing/broker/example-mtbroker.md: versioned/eventing/brokers/broker-developer-config-options.md
+      versioned/eventing/broker/kafka-broker/README.md: versioned/eventing/brokers/broker-types/kafka-broker/README.md
+      versioned/eventing/broker/rabbitmq-broker/README.md: versioned/eventing/brokers/broker-types/rabbitmq-broker/README.md
+      versioned/eventing/broker/README.md: versioned/eventing/brokers/README.md
+      versioned/concepts/resources/revisions.md: versioned/concepts/serving-resources/revisions.md
+      versioned/serving/revision-gc.md: versioned/serving/revisions/revision-developer-config-options.md
+      versioned/serving/configuration/revision-gc.md: versioned/serving/revisions/revision-admin-config-options.md
+      versioned/reference/concepts/duck-typing.md: versioned/concepts/duck-typing.md
+      versioned/reference/client/README.md: versioned/client/README.md
+      versioned/reference/api/eventing-api.md: versioned/eventing/reference/eventing-api.md
+      versioned/reference/api/serving-api.md: versioned/serving/reference/serving-api.md
+      versioned/community/about.md: community/governance.md
+      versioned/contributing/contributing.md: community/contributing.md
+      versioned/contributing/README.md: community/README.md
+      versioned/eventing/getting-started.md: versioned/getting-started/getting-started-eventing.md
+      versioned/admin/collecting-logs/README.md: versioned/serving/observability/logging/collecting-logs.md
+      versioned/admin/collecting-metrics/README.md: versioned/serving/observability/metrics/collecting-metrics.md
+      versioned/admin/collecting-metrics/eventing-metrics/metrics.md: versioned/eventing/observability/metrics/eventing-metrics.md
+      versioned/admin/collecting-metrics/serving-metrics/metrics.md: versioned/serving/observability/metrics/serving-metrics.md
+      versioned/admin/eventing/broker-configuration.md: versioned/eventing/configuration/broker-configuration.md
+      versioned/admin/eventing/channel-configuration.md: versioned/eventing/configuration/channel-configuration.md
+      versioned/admin/eventing/kafka-channel-configuration.md: versioned/eventing/configuration/kafka-channel-configuration.md
+      versioned/admin/eventing/sources-configuration.md: versioned/eventing/configuration/sources-configuration.md
+      versioned/admin/install/README.md: versioned/install/README.md
+      versioned/admin/install/eventing/eventing-installation-files.md: versioned/install/yaml-install/eventing/eventing-installation-files.md
+      versioned/admin/install/eventing/install-eventing-with-yaml.md: versioned/install/yaml-install/eventing/install-eventing-with-yaml.md
+      versioned/admin/install/install-eventing-with-yaml.md: versioned/install/yaml-install/eventing/install-eventing-with-yaml.md
+      versioned/admin/install/install-serving-with-yaml.md: versioned/install/yaml-install/serving/install-serving-with-yaml.md
+      versioned/admin/install/installing-istio.md: versioned/install/installing-istio.md
+      versioned/admin/install/knative-offerings.md: versioned/install/knative-offerings.md
+      versioned/admin/install/knative-with-operators.md: versioned/install/operator/knative-with-operators.md
+      versioned/admin/install/operator/configuring-eventing-cr.md: versioned/install/operator/configuring-eventing-cr.md
+      versioned/admin/install/operator/configuring-serving-cr.md: versioned/install/operator/configuring-serving-cr.md
+      versioned/admin/install/serving/install-serving-with-yaml.md: versioned/install/yaml-install/serving/install-serving-with-yaml.md
+      versioned/admin/install/serving/serving-installation-files.md: versioned/install/yaml-install/serving/serving-installation-files.md
+      versioned/admin/install/uninstall.md: versioned/install/uninstall.md
+      versioned/admin/serving/config-defaults.md: versioned/serving/configuration/config-defaults.md
+      versioned/admin/serving/deployment.md: versioned/serving/configuration/deployment.md
+      versioned/admin/serving/feature-flags.md: versioned/serving/configuration/feature-flags.md
+      versioned/admin/serving/rolling-out-latest-revision-configmap.md: versioned/serving/configuration/rolling-out-latest-revision-configmap.md
+      versioned/admin/upgrade/index.md: versioned/install/upgrade/README.md
+      versioned/admin/upgrade/upgrade-installation-with-operator.md: versioned/install/upgrade/upgrade-installation-with-operator.md
+      versioned/admin/upgrade/upgrade-installation.md: versioned/install/upgrade/upgrade-installation.md
+      versioned/check-install-version.md: versioned/install/upgrade/check-install-version.md
+      versioned/client/connecting-kn-to-your-cluster/index.md: versioned/client/README.md
+      versioned/community/annual_reports.md: https://github.com/knative/community/tree/main/annual_reports
+      versioned/community/calendar.md: https://github.com/knative/community/blob/main/CALENDAR.MD
+      versioned/community/contributing/code-of-conduct.md: https://github.com/knative/community/blob/main/CODE-OF-CONDUCT.md
+      versioned/community/contributing/contributing.md: https://github.com/knative/community/blob/main/CONTRIBUTING.md
+      versioned/community/contributing/governance.md: https://github.com/knative/community/blob/main/GOVERNANCE.md
+      versioned/community/contributing/mechanics.md: https://github.com/knative/community/tree/main/mechanics
+      versioned/community/contributing/mechanics/creating-an-extensions-repo.md: https://github.com/knative/community/blob/main/mechanics/CREATING-AN-EXTENSIONS-REPO.md
+      versioned/community/contributing/mechanics/feature-tracks.md: https://github.com/knative/community/blob/main/mechanics/FEATURE-TRACKS.md
+      versioned/community/contributing/mechanics/golang-policy.md: https://github.com/knative/community/blob/main/mechanics/GOLANG-POLICY.md
+      versioned/community/contributing/mechanics/release-schedule.md: https://github.com/knative/community/blob/main/mechanics/RELEASE-SCHEDULE.md
+      versioned/community/contributing/mechanics/release-versioning-principles.md: https://github.com/knative/community/blob/main/mechanics/RELEASE-VERSIONING-PRINCIPLES.md
+      versioned/community/contributing/mechanics/sc.md: https://github.com/knative/community/blob/main/mechanics/SC.md
+      versioned/community/contributing/mechanics/sunsetting-features.md: https://github.com/knative/community/blob/main/mechanics/SUNSETTING-FEATURES.md
+      versioned/community/contributing/mechanics/toc.md: https://github.com/knative/community/blob/main/mechanics/TOC.md
+      versioned/community/contributing/mechanics/working-group-processes.md: https://github.com/knative/community/blob/main/mechanics/WORKING-GROUP-PROCESSES.md
+      versioned/community/contributing/repository-guidelines.md: https://github.com/knative/community/blob/main/REPOSITORY-GUIDELINES.md
+      versioned/community/contributing/reviewing.md: https://github.com/knative/community/blob/main/REVIEWING.md
+      versioned/community/contributing/roles.md: https://github.com/knative/community/blob/main/ROLES.md
+      versioned/community/contributing/slack-guidelines.md: https://github.com/knative/community/blob/main/SLACK-GUIDELINES.md
+      versioned/community/contributing/steering-committee.md: https://github.com/knative/community/blob/main/STEERING-COMMITTEE.md
+      versioned/community/contributing/tech-oversight-committee.md: https://github.com/knative/community/blob/main/TECH-OVERSIGHT-COMMITTEE.md
+      versioned/community/contributing/trademark-committee.md: https://github.com/knative/community/blob/main/TRADEMARK-COMMITTEE.md
+      versioned/community/contributing/values.md: https://github.com/knative/community/blob/main/VALUES.md
+      versioned/community/contributing/working-groups/working-groups.md: https://github.com/knative/community/blob/main/working-groups
+      versioned/community/meetup.md: community/README.md
+      versioned/community/samples.md: https://github.com/knative/docs/tree/main/code-samples/community
+      versioned/concepts/overview.md: versioned/index.md
+      versioned/developer/concepts/duck-typing.md: versioned/concepts/duck-typing.md
+      versioned/developer/eventing/event-delivery.md: versioned/eventing/event-delivery.md
+      versioned/developer/eventing/sinks/README.md: versioned/eventing/sinks/README.md
+      versioned/developer/eventing/sinks/kafka-sink.md: versioned/eventing/sinks/kafka-sink.md
+      versioned/developer/eventing/sources/README.md: versioned/eventing/sources/README.md
+      versioned/developer/eventing/sources/apiserversource/README.md: versioned/eventing/sources/apiserversource/README.md
+      versioned/developer/eventing/sources/apiserversource/getting-started.md: versioned/eventing/sources/apiserversource/getting-started.md
+      versioned/developer/eventing/sources/apiserversource/reference.md: versioned/eventing/sources/apiserversource/reference.md
+      versioned/developer/eventing/sources/containersource/README.md: versioned/eventing/custom-event-source/containersource/README.md
+      versioned/developer/eventing/sources/containersource/reference.md: versioned/eventing/custom-event-source/containersource/reference.md
+      versioned/developer/eventing/sources/creating-event-sources/README.md: versioned/eventing/custom-event-source/README.md
+      versioned/developer/eventing/sources/creating-event-sources/writing-event-source/01-theory.md: versioned/eventing/custom-event-source/custom-event-source/README.md
+      versioned/developer/eventing/sources/creating-event-sources/writing-event-source/02-lifecycle-and-types.md: versioned/eventing/custom-event-source/custom-event-source/controller.md
+      versioned/developer/eventing/sources/creating-event-sources/writing-event-source/03-controller.md: versioned/eventing/custom-event-source/custom-event-source/README.md
+      versioned/developer/eventing/sources/creating-event-sources/writing-event-source/04-reconciler.md: versioned/eventing/custom-event-source/custom-event-source/receive-adapter.md
+      versioned/developer/eventing/sources/creating-event-sources/writing-event-source/05-receive-adapter.md: versioned/eventing/custom-event-source/custom-event-source/receive-adapter.md
+      versioned/developer/eventing/sources/creating-event-sources/writing-event-source/06-yaml.md: versioned/eventing/custom-event-source/custom-event-source/publish-event-source.md
+      versioned/developer/eventing/sources/creating-event-sources/writing-event-source/07-knative-extensions.md: versioned/eventing/custom-event-source/custom-event-source/README.md
+      versioned/developer/eventing/sources/creating-event-sources/writing-event-source/README.md: versioned/eventing/custom-event-source/custom-event-source/README.md
+      versioned/developer/eventing/sources/kafka-source/README.md: versioned/eventing/sources/kafka-source/README.md
+      versioned/developer/eventing/sources/ping-source/README.md: versioned/eventing/sources/ping-source/README.md
+      versioned/developer/eventing/sources/ping-source/reference.md: versioned/eventing/sources/ping-source/reference.md
+      versioned/developer/eventing/sources/sinkbinding/README.md: versioned/eventing/custom-event-source/sinkbinding/README.md
+      versioned/developer/eventing/sources/sinkbinding/getting-started.md: versioned/eventing/custom-event-source/sinkbinding/create-a-sinkbinding.md
+      versioned/developer/eventing/sources/sinkbinding/reference.md: versioned/eventing/custom-event-source/sinkbinding/reference.md
+      versioned/developer/serving/deploying-from-private-registry.md: versioned/serving/deploying-from-private-registry.md
+      versioned/developer/serving/rolling-out-latest-revision.md: versioned/serving/rolling-out-latest-revision.md
+      versioned/developer/serving/services/README.md: versioned/serving/services/README.md
+      versioned/developer/serving/services/byo-certificate.md: versioned/serving/services/custom-tls-certificate-domain-mapping.md
+      versioned/developer/serving/services/certificate-class.md: versioned/serving/services/certificate-class.md
+      versioned/developer/serving/services/configure-requests-limits-services.md: versioned/serving/services/configure-requests-limits-services.md
+      versioned/developer/serving/services/creating-services.md: versioned/serving/services/creating-services.md
+      versioned/developer/serving/services/custom-domains.md: versioned/serving/services/custom-domains.md
+      versioned/developer/serving/services/http-option.md: versioned/serving/services/http-protocol.md
+      versioned/developer/serving/services/ingress-class.md: versioned/serving/services/ingress-class.md
+      versioned/developer/serving/services/private-services.md: versioned/serving/services/private-services.md
+      versioned/developer/serving/services/service-metrics.md: versioned/serving/observability/metrics/serving-metrics.md
+      versioned/developer/serving/tag-resolution.md: versioned/serving/tag-resolution.md
+      versioned/developer/serving/traffic-management.md: versioned/serving/traffic-management.md
+      versioned/developer/serving/troubleshooting/debugging-application-issues.md: versioned/serving/troubleshooting/debugging-application-issues.md
+      versioned/eventing/broker/alternate/index.md: versioned/eventing/brokers/README.md
+      versioned/eventing/broker/broker-event-delivery.md: versioned/eventing/event-delivery.md
+      versioned/eventing/broker/configmaps/README.md: versioned/eventing/configuration/broker-configuration.md
+      versioned/eventing/channels/default-channels/index.md: versioned/eventing/channels/README.md
+      versioned/eventing/debugging/README.md: versioned/eventing/troubleshooting/README.md
+      versioned/eventing/metrics.md: versioned/eventing/observability/metrics/eventing-metrics.md
+      versioned/eventing/parallel.md: versioned/eventing/flows/parallel.md
+      versioned/eventing/samples/README.md: versioned/samples/eventing.md
+      versioned/eventing/samples/cloud-audit-logs-source/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/cloud-audit-logs-source
+      versioned/eventing/samples/cloud-pubsub-source/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/cloud-pubsub-source
+      versioned/eventing/samples/cloud-scheduler-source/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/cloud-scheduler-source
+      versioned/eventing/samples/cloud-storage-source/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/cloud-storage-source
+      versioned/eventing/samples/gcp-pubsub-source/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/cloud-pubsub-source
+      versioned/eventing/samples/github-source/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/github-source
+      versioned/eventing/samples/gitlab-source/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/gitlab-source
+      versioned/eventing/samples/helloworld/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/helloworld
+      versioned/eventing/samples/helloworld/helloworld-go/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/helloworld/helloworld-go
+      versioned/eventing/samples/helloworld/helloworld-python/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/helloworld/helloworld-python
+      versioned/eventing/samples/kafka/binding/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/kafka/binding
+      versioned/eventing/samples/kafka/channel/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/kafka/channel
+      versioned/eventing/samples/kubernetes-event-source/index.md: versioned/eventing/sources/apiserversource/README.md
+      versioned/eventing/samples/parallel/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/parallel
+      versioned/eventing/samples/parallel/multiple-branches/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/parallel/multiple-branches
+      versioned/eventing/samples/parallel/mutual-exclusivity/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/parallel/mutual-exclusivity
+      versioned/eventing/samples/ping-source/index.md: versioned/eventing/sources/ping-source/README.md
+      versioned/eventing/samples/sequence/index.md: versioned/eventing/flows/sequence/README.md
+      versioned/eventing/samples/sequence/sequence-replay-to-event-display/index.md: versioned/eventing/flows/sequence/sequence-reply-to-event-display/README.md
+      versioned/eventing/samples/sequence/sequence-reply-to-sequence/index.md: versioned/eventing/flows/sequence/sequence-reply-to-sequence/README.md
+      versioned/eventing/samples/sequence/sequence-terminal/index.md: versioned/eventing/flows/sequence/sequence-terminal/README.md
+      versioned/eventing/samples/sequence/sequence-with-broker-trigger/index.md: versioned/eventing/flows/sequence/sequence-with-broker-trigger/README.md
+      versioned/eventing/samples/sinkbinding/README.md: versioned/eventing/custom-event-source/sinkbinding/README.md
+      versioned/eventing/samples/writing-event-source-easy-way/README.md: https://github.com/knative/docs/tree/main/code-samples/eventing/writing-event-source-easy-way
+      versioned/eventing/sequence.md: versioned/eventing/flows/sequence/README.md
+      versioned/eventing/sink/README.md: versioned/eventing/sinks/README.md
+      versioned/eventing/sink/kafka-sink.md: versioned/eventing/sinks/kafka-sink.md
+      versioned/eventing/sources/containersource.md: versioned/eventing/custom-event-source/containersource/README.md
+      versioned/eventing/sources/pingsource/index.md: versioned/eventing/sources/ping-source/README.md
+      versioned/install/collecting-logs/index.md: versioned/serving/observability/logging/collecting-logs.md
+      versioned/install/collecting-metrics/index.md: versioned/serving/observability/metrics/collecting-metrics.md
+      versioned/install/eventing/eventing-installation-files.md: versioned/install/yaml-install/eventing/eventing-installation-files.md
+      versioned/install/eventing/install-eventing-with-yaml.md: versioned/install/yaml-install/eventing/install-eventing-with-yaml.md
+      versioned/install/getting-started-knative-app/index.md: versioned/getting-started/README.md
+      versioned/install/install-extensions.md: versioned/install/README.md
+      versioned/install/installation-files.md: versioned/install/README.md
+      versioned/install/prerequisites.md: versioned/install/README.md
+      versioned/install/serving/install-serving-with-yaml.md: versioned/install/yaml-install/serving/install-serving-with-yaml.md
+      versioned/install/serving/installing-cert-manager.md: versioned/install/installing-cert-manager.md
+      versioned/install/serving/installing-istio.md: versioned/install/installing-istio.md
+      versioned/install/serving/serving-installation-files.md: versioned/install/yaml-install/serving/serving-installation-files.md
+      versioned/operator/configuring-eventing-cr/index.md: versioned/install/operator/configuring-eventing-cr.md
+      versioned/operator/configuring-serving-cr/index.md: versioned/install/operator/configuring-serving-cr.md
+      versioned/reference/resources/index.md: versioned/client/README.md
+      versioned/serving/autoscaling/autoscaling-concepts.md: versioned/serving/autoscaling/autoscaler-types.md
+      versioned/serving/autoscaling/target-burst-capacity/index.md: versioned/serving/load-balancing/target-burst-capacity.md
+      versioned/serving/configuring-autoscaling/index.md: versioned/serving/autoscaling/README.md
+      versioned/serving/creating-domain-mappings.md: versioned/serving/services/custom-domains.md
+      versioned/serving/debugging-application-issues.md: versioned/serving/troubleshooting/debugging-application-issues.md
+      versioned/serving/feature-flags.md: versioned/serving/configuration/feature-flags.md
+      versioned/serving/getting-started-knative-app.md: versioned/getting-started/README.md
+      versioned/serving/installing-cert-manager.md: versioned/install/installing-cert-manager.md
+      versioned/serving/metrics.md: versioned/serving/observability/metrics/serving-metrics.md
+      versioned/serving/samples/README.md: versioned/samples/serving.md
+      versioned/serving/samples/autoscale-go/index.md: versioned/serving/autoscaling/autoscale-go/README.md
+      versioned/serving/samples/blue-green-deployment.md: versioned/serving/traffic-management.md
+      versioned/serving/samples/cloudevents/cloudevents-dotnet/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/cloudevents/cloudevents-dotnet
+      versioned/serving/samples/cloudevents/cloudevents-go/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/cloudevents/cloudevents-go
+      versioned/serving/samples/cloudevents/cloudevents-nodejs/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/cloudevents/cloudevents-nodejs
+      versioned/serving/samples/cloudevents/cloudevents-rust/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/cloudevents/cloudevents-rust
+      versioned/serving/samples/cloudevents/cloudevents-spring/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/cloudevents/cloudevents-spring
+      versioned/serving/samples/cloudevents/cloudevents-vertx/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/cloudevents/cloudevents-vertx
+      versioned/serving/samples/gitwebhook-go/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/gitwebhook-go
+      versioned/serving/samples/grpc-ping-go/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/grpc-ping-go
+      versioned/serving/samples/hello-world/helloworld-csharp/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/hello-world/helloworld-csharp
+      versioned/serving/samples/hello-world/helloworld-go/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/hello-world/helloworld-go
+      versioned/serving/samples/hello-world/helloworld-java-spark/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/hello-world/helloworld-java-spark
+      versioned/serving/samples/hello-world/helloworld-java-spring/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/hello-world/helloworld-java-spring
+      versioned/serving/samples/hello-world/helloworld-kotlin/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/hello-world/helloworld-kotlin
+      versioned/serving/samples/hello-world/helloworld-nodejs/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/hello-world/helloworld-nodejs
+      versioned/serving/samples/hello-world/helloworld-php/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/hello-world/helloworld-php
+      versioned/serving/samples/hello-world/helloworld-python/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/hello-world/helloworld-python
+      versioned/serving/samples/hello-world/helloworld-ruby/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/hello-world/helloworld-ruby
+      versioned/serving/samples/hello-world/helloworld-scala/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/hello-world/helloworld-scala
+      versioned/serving/samples/hello-world/helloworld-shell/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/hello-world/helloworld-shell
+      versioned/serving/samples/knative-routing-go/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/knative-routing-go
+      versioned/serving/samples/kong-routing-go/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/kong-routing-go
+      versioned/serving/samples/multi-container/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/multicontainer
+      versioned/serving/samples/secrets-go/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/secrets-go
+      versioned/serving/samples/tag-header-based-routing/README.md: https://github.com/knative/docs/tree/main/code-samples/serving/tag-header-based-routing
+      versioned/serving/samples/traffic-splitting/README.md: versioned/serving/traffic-management.md
+      versioned/serving/services/deployment.md: versioned/serving/configuration/deployment.md
+      versioned/serving/services/http-option.md: versioned/serving/services/http-protocol.md
+      versioned/serving/services/service-metrics.md: versioned/serving/observability/metrics/serving-metrics.md
+      versioned/serving/spec/knative-api-specification-1.0.md: https://github.com/knative/specs/blob/main/specs/serving/knative-api-specification-1.0.md
+      versioned/serving/using-an-ssl-cert/index.md: versioned/serving/encryption/encryption-overview.md
+      versioned/serving/encryption/enabling-automatic-tls-certificate-provisioning.md: versioned/serving/encryption/encryption-overview.md
+      versioned/serving/encryption/using-certificates-in-networking-layer.md: versioned/serving/encryption/encryption-overview.md
+      versioned/serving/using-subroutes.md: versioned/serving/traffic-management.md
+      versioned/eventing/brokers/create-mtbroker.md: versioned/eventing/brokers/create-broker.md
+      versioned/eventing/brokers/broker-admin-config-options.md: versioned/eventing/configuration/broker-configuration.md

docs/concepts/eventing-resources/brokers.md

@@ -1,28 +0,0 @@
----
-audience: developer
-components:
-  - eventing
-function: explanation
----
-
-# Brokers
-
---8<-- "about-brokers.md"
-
-## Related concepts
-
-### Triggers
-
---8<-- "about-triggers.md"
-
-### Subscribers
-
---8<-- "about-subscribers.md"
-
-<!--
-## Additional resources
-
-## Next steps
-
-Placeholder to add these later
--->

docs/serving/revisions/README.md

@@ -1,14 +0,0 @@
----
-audience: developer
-components:
-  - serving
-function: explanation
----
-
-# About Revisions
-
---8<-- "about-revisions.md"
-
-## Additional resources
-
-- [Revisions concept documentation](../../concepts/serving-resources/revisions.md){target=_blank}

docs/snippets/about-brokers.md

@@ -1,6 +1,5 @@
 <!-- Snippet used in the following topics:
-- /docs/concepts/eventing-resources/brokers.md
-- /docs/eventing/broker/README.md
+- versioned/eventing/broker/README.md
 -->
 
 Brokers are Kubernetes custom resources that define an [event mesh](/docs/eventing/event-mesh) for collecting a pool of events. Brokers provide a discoverable endpoint for event ingress, and use Triggers for event delivery. Event producers can send events to a broker by POSTing the event.

docs/snippets/about-eventing.md

@@ -1,6 +1,6 @@
 <!-- Snippet used in the following topics:
-- /docs/eventing/README.md
-- /docs/concepts/README.md
+- versioned/eventing/README.md
+- versioned/README.md
 -->
 Knative Eventing is a collection of APIs that enable you to use an [event-driven architecture](https://en.wikipedia.org/wiki/Event-driven_architecture){target=_blank} with your applications. You can use these APIs to create components that route events from event producers (known as sources) to event consumers (known as sinks) that receive events. Sinks can also be configured to respond to HTTP requests by sending a response event.
 

docs/snippets/about-functions.md

@@ -1,5 +1,6 @@
 <!-- Snippet used in the following topics:
-- /docs/functions/README.md
+- versioned/functions/README.md
+- versioned/README.md
 -->
 Knative Functions provides a simple programming model for using functions on Knative, without requiring in-depth knowledge of Knative, Kubernetes, containers, or dockerfiles.
 

docs/snippets/about-revisions-garbage-collection.md

@@ -1,6 +1,6 @@
 <!-- Snippet used in the following topics:
-- docs/serving/revisions/revision-admin-config-options.md
-- docs/serving/revisions/revision-developer-config-options.md
+- versioned/serving/revisions/revision-admin-config-options.md
+- versioned/serving/revisions/revision-developer-config-options.md
 -->
 When Revisions of a Knative Service are inactive, they are automatically cleaned up and cluster resources are reclaimed after a set time period. This is known as *[garbage collection](https://kubernetes.io/docs/concepts/architecture/garbage-collection/){target=_blank}*.
 

docs/snippets/about-revisions.md

@@ -1,6 +1,5 @@
 <!-- Snippet used in the following topics:
-- /docs/concepts/servng-resources/revisions.md
-- /docs/serving/revisions/README.md
+- versioned/serving/revisions/README.md
 -->
 Revisions are Knative Serving resources that contain point-in-time snapshots of the application code and configuration for each change made to a Knative Service.
 

docs/snippets/about-serving.md

@@ -1,6 +1,6 @@
 <!-- Snippet used in the following topics:
-- /docs/serving/README.md
-- /docs/concepts/README.md
+- versioned/serving/README.md
+- versioned/README.md
 -->
 Knative Serving defines a set of objects as Kubernetes Custom Resource
 Definitions (CRDs). These resources are used to define and control how your

docs/snippets/about-subscribers.md

@@ -1,5 +0,0 @@
-<!-- Snippet used in the following topics:
-- /docs/concepts/eventing-resources/brokers.md
--->
-
-A Subscriber can be any URL or Addressable resource. Subscribers can also reply to an active request from the Broker, and can respond with a new event that is sent back into the Broker.

docs/snippets/about-triggers.md

@@ -1,5 +0,0 @@
-<!-- Snippet used in the following topics:
-- /docs/concepts/eventing-resources/brokers.md
--->
-
-After an event has entered a broker, it can be forwarded to subscribers by using Triggers. Triggers allow events to be filtered by attributes, so that events with particular attributes can be sent to Subscribers that have registered interest in events with those attributes.

docs/snippets/build-func-intro.md

@@ -1,5 +1,5 @@
 <!-- Snippet used in the following topics:
-- /docs/getting-started/build-run-deploy-func.md
-- /docs/functions/building-functions.md
+- versioned/getting-started/build-run-deploy-func.md
+- versioned/functions/building-functions.md
 -->
 Building a function creates an OCI container image for your function that can be pushed to a container registry. It does not run or deploy the function, which can be useful if you want to build a container image for your function locally, but do not want to automatically run the function or deploy it to a cluster, for example, in a testing scenario.

docs/snippets/create-a-function.md

@@ -1,5 +1,6 @@
 <!-- Snippet used in the following topics:
-- /docs/concepts/eventing-resources/brokers.md
+- versioned/functions/creating-functions.md
+- versioned/getting-started/create-a-function.md
 -->
 After you have installed Knative Functions, you can create a function project by using the `func` CLI or the `kn func` plugin:
 

docs/snippets/deploy-func-intro.md

@@ -1,5 +1,5 @@
 <!-- Snippet used in the following topics:
-- /docs/getting-started/build-run-deploy-func.md
-- /docs/functions/deploying-functions.md
+- versioned/getting-started/build-run-deploy-func.md
+- versioned/functions/deploying-functions.md
 -->
 Deploying a function creates an OCI container image for your function, and pushes this container image to your image registry. The function is deployed to the cluster as a Knative Service. Redeploying a function updates the container image and resulting Service that is running on your cluster. Functions that have been deployed to a cluster are accessible on the cluster just like any other Knative Service.

docs/snippets/functions-templates-intro.md

@@ -1,5 +1,5 @@
 <!-- Snippet used in the following topics:
-- /docs/functions/README.md
+- versioned/functions/README.md
 -->
 Knative Functions provides templates that can be used to create basic functions, by initiating a function project boilerplate when you run a `create` command.
 

docs/snippets/install-func-CLI.md

@@ -1,6 +1,6 @@
 <!-- Snippet used in the following topics:
-- /docs/functions/install-func.md
-- /docs/getting-started/install-func.md
+- versioned/functions/install-func.md
+- versioned/getting-started/install-func.md
 -->
 === "Homebrew"
 

docs/snippets/install-functions-intro.md

@@ -1,4 +1,5 @@
 <!-- Snippet used in the following topics:
-- /docs/functions/install-func.md
+- versioned/functions/install-func.md
+- versioned/getting-started/install-func.md
 -->
 You can install Knative Functions either by using the standalone `func` CLI, or by installing the `kn func` plugin that is available for the Knative `kn` CLI.

docs/snippets/install-kn-func-plugin.md

@@ -1,6 +1,6 @@
 <!-- Snippet used in the following topics:
-- /docs/functions/install-func.md
-- /docs/getting-started/install-func.md
+- versioned/functions/install-func.md
+- versioned/getting-started/install-func.md
 -->
 === "kn plugin"
 

docs/snippets/install-kn.md

@@ -1,7 +1,7 @@
 <!-- Snippet used in the following topics:
-- /docs/client/install-kn.md
-- /docs/getting-started/quickstart-install.md
-- docs/install/quickstart-install.md
+- versioned/client/install-kn.md
+- versioned/getting-started/quickstart-install.md
+- versioned/install/quickstart-install.md
 -->
 
 ## Install the Knative CLI

docs/snippets/proc-building-function.md

@@ -1,6 +1,6 @@
 <!-- Snippet used in the following topics:
-- /docs/getting-started/build-run-deploy-func.md
-- /docs/functions/building-functions.md
+- versioned/getting-started/build-run-deploy-func.md
+- versioned/functions/building-functions.md
 -->
 The `build` command uses the project name and the image registry name to construct a fully qualified container image name for the function. If the function project has not previously been built, you are prompted to provide an **image registry**.
 

docs/snippets/proc-deploying-function.md

@@ -1,6 +1,6 @@
 <!-- Snippet used in the following topics:
-- /docs/getting-started/build-run-deploy-func.md
-- /docs/functions/deploying-functions.md
+- versioned/getting-started/build-run-deploy-func.md
+- versioned/functions/deploying-functions.md
 -->
 The `deploy` command uses the function project name as the Knative Service name. When the function is built, the project name and the image registry name are used to construct a fully qualified image name for the function.
 

docs/snippets/proc-running-function.md

@@ -1,6 +1,6 @@
 <!-- Snippet used in the following topics:
-- /docs/getting-started/build-run-deploy-func.md
-- /docs/functions/running-functions.md
+- versioned/getting-started/build-run-deploy-func.md
+- versioned/functions/running-functions.md
 -->
 The `run` command builds an image for your function if required, and runs this image locally, instead of deploying it on a cluster.
 

docs/snippets/quickstart-install.md

@@ -1,6 +1,6 @@
 <!-- Snippet used in the following topics:
-- /docs/getting-started/quickstart-install.md
-- /docs/install/quickstart-install.md
+- versioned/getting-started/quickstart-install.md
+- versioned/install/quickstart-install.md
 -->
 ## Install the Knative quickstart plugin
 

docs/snippets/quickstart-prereqs.md

@@ -1,7 +1,7 @@
 <!-- Snippet used in the following topics:
-- /docs/getting-started/README.md
-- /docs/install/quickstart-install.md
-- /docs/getting-started/quickstart-install.md
+- versioned/getting-started/README.md
+- versioned/install/quickstart-install.md
+- versioned/getting-started/quickstart-install.md
 -->
 ## Before you begin
 

docs/snippets/run-func-intro.md

@@ -1,5 +1,5 @@
 <!-- Snippet used in the following topics:
-- /docs/getting-started/build-run-deploy-func.md
-- /docs/functions/running-functions.md
+- versioned/getting-started/build-run-deploy-func.md
+- versioned/functions/running-functions.md
 -->
 Running a function creates an OCI container image for your function before running the function in your local environment, but does not deploy the function to a cluster. This can be useful if you want to run your function locally for a testing scenario.

docs/versioned/.nav.yml

@@ -2,14 +2,7 @@ nav:
 ###############################################################################
     # Concepts
 ###############################################################################
-    - Concepts:
-      - Overview: concepts/README.md
-      - Resources:
-        - Serving resources:
-          - Revisions: concepts/serving-resources/revisions.md
-        - Eventing resources:
-          - Brokers: concepts/eventing-resources/brokers.md
-      - Duck types: concepts/duck-typing.md
+    - Overview: README.md
 ###############################################################################
     # Getting started
 ###############################################################################
@@ -214,6 +207,7 @@ nav:
           - Developer configuration options: eventing/brokers/broker-developer-config-options.md
         - Triggers:
           - Using Triggers: eventing/triggers/README.md
+        - Duck types: eventing/concepts/duck-typing.md
         - Event sources:
           - About event sources: eventing/sources/README.md
           - ApiServerSource:

docs/versioned/README.md

@@ -74,7 +74,7 @@ These components can be used independently or together, allowing you to adopt Kn
 
 ### Request Flow in Serving
 
-![Knative Serving data flow: requests arrive at an HTTP router, then travel to either the activator or a pod with a queue-proxy and the user application. The Knative autoscaler collects metrics from the activator and the queue-proxy to determine how many pods to run.](../serving/images/request-flow.png){draggable=false}
+![Knative Serving data flow: requests arrive at an HTTP router, then travel to either the activator or a pod with a queue-proxy and the user application. The Knative autoscaler collects metrics from the activator and the queue-proxy to determine how many pods to run.](./serving/images/request-flow.png){draggable=false}
 
 When a request is made to a Knative Service:
 
@@ -84,7 +84,7 @@ When a request is made to a Knative Service:
 4. **Queue-Proxy**: All requests pass through the Queue-Proxy sidecar, which enforces concurrency limits and collects metrics
 5. **Application**: The request reaches your application container
 
-For detailed information, see the [request flow documentation](../serving/request-flow.md).
+For detailed information, see the [request flow documentation](serving/request-flow.md).
 
 ### GPU Resources and LLM Inference
 
@@ -261,9 +261,9 @@ Consider alternatives when:
 
 ## Next Steps
 
-- **Installation**: Get started with [Knative installation](../install/README.md)
-- **Quick Start**: Try the [Knative Quickstart](../getting-started/README.md) for hands-on experience
-- **Serving Guide**: Learn more about [Knative Serving](../serving/README.md)
-- **Eventing Guide**: Explore [Knative Eventing](../eventing/README.md) capabilities
-- **Functions Guide**: Build your first [Knative Function](../functions/README.md)
-- **Examples**: Browse [sample applications](../samples/README.md) and use cases
+- **Installation**: Get started with [Knative installation](install/README.md)
+- **Quick Start**: Try the [Knative Quickstart](getting-started/README.md) for hands-on experience
+- **Serving Guide**: Learn more about [Knative Serving](serving/README.md)
+- **Eventing Guide**: Explore [Knative Eventing](eventing/README.md) capabilities
+- **Functions Guide**: Build your first [Knative Function](functions/README.md)
+- **Examples**: Browse [sample applications](samples/README.md) and use cases