Updated landing page

community/contributing/_index.md

@@ -11,4 +11,45 @@ aliases:
 
 Learn how to join the community of Knative contributors.
 
+## Audience
+
+Knative is designed for different personas:
+
+![Diagram that displays different Audiences for Knative](./images/knative-audience.svg)
+
+### Developers
+
+Knative components offer developers Kubernetes-native APIs for deploying
+serverless-style functions, applications, and containers to an auto-scaling
+runtime.
+
+To join the conversation, head over to the
+[Knative users](https://groups.google.com/d/forum/knative-users) Google group.
+
+### Operators
+
+Knative components are intended to be integrated into more polished products
+that cloud service providers or in-house teams in large enterprises can then
+operate.
+
+Any enterprise or cloud provider can adopt Knative components into their own
+systems and pass the benefits along to their customers.
+
+### Contributors
+
+With a clear project scope, lightweight governance model, and clean lines of
+separation between pluggable components, the Knative project establishes an
+efficient contributor workflow.
+
+Knative is a diverse, open, and inclusive community.
+Your own path to becoming a Knative contributor can begin in any of the
+following components:
+
+- [serving](https://github.com/knative/serving/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Akind%2Fgood-first-issue)
+- [eventing](https://github.com/knative/eventing/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Akind%2Fgood-first-issue)
+- [documentation](https://github.com/knative/docs/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Akind%2Fgood-first-issue)
+
+[Bug reports](https://github.com/knative/serving/issues/new) and friction logs
+from new developers are especially welcome.
+
 {{% readfile file="README.md" %}}

docs/README.md

@@ -1,75 +1,18 @@
 
-Knative (pronounced kay-nay-tiv) extends
-[Kubernetes](https://kubernetes.io/docs/concepts/overview/what-is-kubernetes/)
-to provide a set of middleware components that are essential to build modern,
-source-centric, and container-based applications that can run anywhere: on
-premises, in the cloud, or even in a third-party data center.
+Knative extends Kubernetes to provide developers with a set of tools that simplify the process of deploying and managing event-driven applications that can run anywhere.
 
-Each of the components under the Knative project attempt to identify common
-patterns and codify the best practices that are shared by successful,
-real-world, Kubernetes-based frameworks and applications. Knative components
-focus on solving mundane but difficult tasks such as:
+Developers using Knative can use familiar languages and frameworks to solve common use cases, such as:
 
 - [Deploying a container](./serving/getting-started-knative-app.md)
 - [Routing and managing traffic with blue/green deployment](./serving/samples/blue-green-deployment.md)
 - [Scaling automatically and sizing workloads based on demand](./serving/autoscaling)
 - [Binding running services to eventing ecosystems](./eventing/getting-started.md)
 
-Developers on Knative can use familiar idioms, languages, and frameworks to
-deploy functions, applications, or containers workloads.
+## How it works
 
-## Components
+Knative consists of the [Knative Serving](./serving) and [Knative Eventing](./eventing) components.
 
-Knative consists of the Serving and Eventing components:
-
-- [Eventing](./eventing) - Management and delivery of events
-- [Serving](./serving) - Request-driven compute that can scale to zero
-
-## Audience
-
-Knative is designed for different personas:
-
-![Diagram that displays different Audiences for Knative](./images/knative-audience.svg)
-
-### Developers
-
-Knative components offer developers Kubernetes-native APIs for deploying
-serverless-style functions, applications, and containers to an auto-scaling
-runtime.
-
-To join the conversation, head over to the
-[Knative users](https://groups.google.com/d/forum/knative-users) Google group.
-
-### Operators
-
-Knative components are intended to be integrated into more polished products
-that cloud service providers or in-house teams in large enterprises can then
-operate.
-
-Any enterprise or cloud provider can adopt Knative components into their own
-systems and pass the benefits along to their customers.
-
-### Contributors
-
-With a clear project scope, lightweight governance model, and clean lines of
-separation between pluggable components, the Knative project establishes an
-efficient contributor workflow.
-
-Knative is a diverse, open, and inclusive community. To get involved, see
-[CONTRIBUTING.md](https://github.com/knative/community/tree/master/CONTRIBUTING.md) and join the
-[Knative community](../community/).
-
-Your own path to becoming a Knative contributor can begin in any of the
-following components:
-
-- [serving](https://github.com/knative/serving/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Akind%2Fgood-first-issue)
-- [eventing](https://github.com/knative/eventing/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Akind%2Fgood-first-issue)
-- [documentation](https://github.com/knative/docs/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Akind%2Fgood-first-issue)
-
-[Bug reports](https://github.com/knative/serving/issues/new) and friction logs
-from new developers are especially welcome.
-
-## Documentation
+These components are delivered as Kubernetes custom resource definitions (CRDs), which can be configured by a cluster administrator to provide default settings for developer-created applications and event workflow components.
 
 Follow the links below to learn more about Knative.