Merge pull request #132 from tv2-oss/doc/fix-link-editorial-updates

Fix link, Editorial doc updates

Author: michaelvl

README.md

@@ -4,7 +4,9 @@ The *bifrost-gateway-controller* is an augmented Kubernetes network
 gateway-controller -- think of it as a Kubernetes ingress-controller
 that not only provides a data-path inside Kubernetes, but extends the
 data-path outside Kubernetes into the surrounding cloud
-infrastructure.
+infrastructure. The *bifrost-gateway-controller* is different in that
+the data-path implementation is not hardcoded but instead based on generic,
+shareable blueprints. This makes it cloud-agnostic and extensible.
 
 > **Status: Alpha**. The *bifrost-gateway-controller* is under active
 > development and functionality and particularly CRDs may change.
@@ -13,16 +15,17 @@ infrastructure.
 - [Getting Started using a KIND Cluster](doc/getting-started.md)
 - [Example GatewayClassBlueprints](blueprints/README.md)
 - [Creating GatewayClass Definitions](doc/creating-gatewayclass-definitions.md)
-- [Extending GatewayClass Definitions using Policy Attachments](doc/extended-configuration-w-policy-attachments.md)
+- [Extending GatewayClass Definitions using Policy Attachments (GEP-713)](doc/extended-configuration-w-policy-attachments.md)
 - [User Journeys](doc/user-journeys.md)
 - [About the Bifrost Name](doc/bifrost-name.md)
 
 ## TL;DR
 
 The *bifrost-gateway-controller* is a cloud-agnostic solution for
-orchestrating end-to-end datapaths through cloud and Kubernetes using
-the [Kubernetes Gateway API](https://gateway-api.sigs.k8s.io/). An
-example using AWS load-balancer and Istio is shown below. This is,
+orchestrating end-to-end datapaths through cloud and Kubernetes
+resources using the [Kubernetes Gateway
+API](https://gateway-api.sigs.k8s.io/). An example using Crossplane to
+provision a cloud load-balancer and Istio is shown below. This is,
 however, only one possible [GatewayClass
 Definition](doc/creating-gatewayclass-definitions.md).
 

doc/creating-gatewayclass-definitions.md

@@ -2,7 +2,7 @@
 
 This document describes how to create new `GatewayClass`
 definitions. See also [Example GatewayClass
-Definitions](example-gatewayclasses.md) for the definitions provided
+Definitions](../blueprints/README.md) for the definitions provided
 with the *bifrost-gateway-controller*.
 
 Before preparing new `GatewayClass` definitions, it is important to