Update building block descriptions

daprdocs/content/en/developing-applications/_index.md

@@ -4,4 +4,4 @@ title: "Developing applications with Dapr"
 linkTitle: "Developing applications"
 description: "Tools, tips, and information on how to build your application with Dapr"
 weight: 30
----
+---

daprdocs/content/en/developing-applications/building-blocks/_index.md

@@ -6,4 +6,6 @@ weight: 10
 description: "Dapr capabilities that solve common development challenges for distributed applications"
 ---
 
-Get a high-level [overview of Dapr building blocks](/docs/concepts/building-blocks/) at the **Concepts** section 
+Get a high-level [overview of Dapr building blocks](/docs/concepts/building-blocks/) in the **Concepts** section.
+
+<img src="/images/buildingblocks-overview.png" alt="Diagram showing the different Dapr building blocks" width=1000>

daprdocs/content/en/developing-applications/building-blocks/actors/_index.md

@@ -3,5 +3,5 @@ type: docs
 title: "Actors"
 linkTitle: "Actors"
 weight: 50
-description: Use Dapr to implement the actor programming model in your application
+description: Encapsulate code and data in reusable actor objects as a common microservices design pattern
 ---

daprdocs/content/en/developing-applications/building-blocks/bindings/_index.md

@@ -3,5 +3,5 @@ type: docs
 title: "Bindings"
 linkTitle: "Bindings"
 weight: 40
-description: Use Dapr to invoke external systems and build event driven applications
+description: Trigger code from and interface with a large array of external resources
 ---

daprdocs/content/en/developing-applications/building-blocks/observability/_index.md

@@ -3,7 +3,7 @@ type: docs
 title: "Observability"
 linkTitle: "Observability"
 weight: 60
-description: Dapr capabilities for tracing, logs and metrics
+description: See and measure the message calls across components and networked services
 ---
 
 This section includes guides for developers in the context of observability. See other sections for a [general overview of the observability concept](/docs/concepts/observability/) in Dapr and for [operations guidance on monitoring](/docs/operations/monitoring/).

daprdocs/content/en/developing-applications/building-blocks/pubsub/_index.md

@@ -3,5 +3,5 @@ type: docs
 title: "Pub/Sub"
 linkTitle: "Pub/Sub"
 weight: 30
-description: "Use publish and subscribe messaging in a distributed application"
+description: Secure, scalable messaging between services
 ---

daprdocs/content/en/developing-applications/building-blocks/secrets/_index.md

@@ -1,7 +1,7 @@
 ---
 type: docs
-title: "Secrets stores"
-linkTitle: "Secrets stores"
+title: "Secrets building block"
+linkTitle: "Secrets"
 weight: 70
-description: "Retrieve secrets securely from managed secret stores"
+description: Securely access secrets from your application
 ---

daprdocs/content/en/developing-applications/building-blocks/state-management/_index.md

@@ -3,5 +3,5 @@ type: docs
 title: "State management"
 linkTitle: "State management"
 weight: 20
-description: "Use state management to create a stateful service"
+description: Create long running stateful services
 ---

daprdocs/content/en/operations/configuration/grpc.md

@@ -8,7 +8,7 @@ description: "How to configure Dapr to use gRPC for low-latency, high performanc
 
 Dapr implements both an HTTP and a gRPC API for local calls. gRPC is useful for low-latency, high performance scenarios and has language integration using the proto clients.
 
-You can find a list of auto-generated clients [here](https://github.com/dapr/docs#sdks).
+You can find a list of auto-generated clients [here]({{< ref sdks >}}).
 
 The Dapr runtime implements a [proto service](https://github.com/dapr/dapr/blob/master/dapr/proto/runtime/v1/dapr.proto) that apps can communicate with via gRPC.