Update readme (tensorflow#26)

Author: rgregg

README.md

@@ -19,52 +19,36 @@ turn frees application developers to spend more time writing
 interesting code, not worrying about how they are going to build,
 deploy, monitor, and debug it.
 
+## Getting started with Knative
 
-# What are the Knative components?
+To get started using Knative, [pick a Kubernetes cluster of your choice](https://kubernetes.io/docs/setup/pick-right-solution/)
+and follow the [Knative installation instructions](/install/install-on-gke.md)
+to get the system up.
 
-Currently, Knative consists of the following top-level repositories:
-
-- [build](https://github.com/knative/build) and
-    [build-templates](https://github.com/knative/build-templates) —
-    automatic, repeatable server-side container builds
-- [serving](https://github.com/knative/serving) — scale to zero,
-  request-driven compute
-- [eventing](https://github.com/knative/eventing) — management and
-  delivery of events
-
-We expect this list to grow as more areas are identified.
-
-
-# How do I use Knative?
+There are a [number of samples](serving/samples/README.md) to help you get acquanted you can build
+and run on your cluster once it's set up.
 
 You can choose to install individual Knative components following the
 instructions in each repo, or install a pre-built suite of components
-by following the instructions at https://github.com/knative/install.
+by following the instructions for your platform:
 
+- [Google Kubernetes Engine](install/install-on-gke.md)
+- [MiniKube](install/install-on-minikube.md)
 
-# Who is Knative for?
+## Who is Knative for
 
-Knative is being created with several
-[personas](./docs/product/personas.md) in mind.
+Knative was created with several personas in mind:
 
-**Developers**
+### Developers
 
 Knative components offer Kubernetes-native APIs for deploying
-functions, applications, and containers to an auto-scaling runtime.
-
-To get started as a developer, [pick a Kubernetes cluster of your
-choice](https://kubernetes.io/docs/setup/pick-right-solution/) and
-follow the [Knative installation
-instructions](https://github.com/knative/install) to get the system up
-and running and [run some sample code](./sample/README.md). The
-install instructions also include a [sample
-application](https://github.com/knative/install#test-app) which
-demonstrates some of the key features of Knative.
+serverless-style functions, applications, and containers to an auto-scaling
+runtime.
 
-To join the conversation, head over to
-https://groups.google.com/d/forum/knative-users.
+To join the conversation, head over to the
+[Knative Users](https://groups.google.com/d/forum/knative-users) Google group.
 
-**Operators**
+### Operators
 
 Knative components are intended to be integrated into more polished
 products that cloud service providers or in-house teams in large
@@ -73,19 +57,35 @@ 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**
+### 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](./CONTRIBUTING.md) and
-[DEVELOPMENT.md](./DEVELOPMENT.md) and join the
-[#community](https://knative.slack.com/messages/C92U2C59P/) Slack
-channel.
+see [CONTRIBUTING.md](https://github.com/knative/serving/CONTRIBUTING.md) and
+[DEVELOPMENT.md](https://github.com/knative/serving/DEVELOPMENT.md) and join the
+[#community](https://knative.slack.com/messages/C92U2C59P/) Slack channel.
 
-Your own path to becoming a Knative contributor can [begin
-anywhere](https://github.com/knative/serving/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22).
+Your own path to becoming a Knative contributor can
+[begin anywhere](https://github.com/knative/serving/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22).
 [Bug reports](https://github.com/knative/serving/issues/new) and
 friction logs from new developers are especially welcome.
+
+## What are the Knative components
+
+Currently, Knative consists of the following top-level repositories:
+
+- [build](https://github.com/knative/build) and
+  [build-templates](https://github.com/knative/build-templates) —
+  automatic, repeatable server-side container builds
+- [docs](https://github.com/knative/docs) - documentation for developers and
+  operators using Knative components.
+- [eventing](https://github.com/knative/eventing) — management and
+  delivery of events
+- [serving](https://github.com/knative/serving) — scale to zero,
+  request-driven compute
+
+We expect this list to grow as more areas are identified.
+