Sync content/master -> content/v2.0

Signed-off-by: Nic Cope <nicc@rk0n.org>

Author: negz

content/v2.0/cli/_index.md

@@ -1,7 +1,7 @@
 ---
 weight: 200
 title: CLI Reference
-description: "Documentation for the Crossplane command-line interface"
+description: "Command-line tools for Crossplane development"
 ---
 
 The Crossplane CLI helps simplify some development and administration aspects of

content/v2.0/composition/_index.md

@@ -1,5 +1,7 @@
 ---
 title: Composition
 weight: 51
-description: Understand Crossplane's core components
+description: Build custom APIs by composing Kubernetes resources
 ---
+
+{{< auto-index >}}

content/v2.0/composition/composite-resource-definitions.md

@@ -1,7 +1,7 @@
 ---
 title: Composite Resource Definitions
 weight: 20
-description: "Composite Resource Definitions or XRDs define custom API schemas"
+description: "Define schemas for composite resources"
 ---
 
 Composite resource definitions (`XRDs`) define the schema for a custom API.

content/v2.0/composition/composite-resources.md

@@ -1,7 +1,7 @@
 ---
 title: Composite Resources
 weight: 10
-description: "Composite resources, an XR or XRs, represent a collection of related cloud resources."
+description: "Custom APIs created by composing Kubernetes resources"
 ---
 
 A composite resource, or XR, represents a set of Kubernetes resources as a

content/v2.0/composition/composition-revisions.md

@@ -1,6 +1,7 @@
 ---
 title: Composition Revisions
 weight: 35
+description: "Manage changes to Compositions with revisions"
 ---
 
 This guide discusses the use of "Composition Revisions" to make and roll

content/v2.0/composition/compositions.md

@@ -5,7 +5,7 @@ aliases:
   - composition
   - composition-functions
   - /knowledge-base/guides/composition-functions
-description: "Compositions are a template for creating composite resources"
+description: "Define which resources to create and how"
 ---
 
 Compositions are a template for creating multiple Kubernetes resources as a
@@ -140,7 +140,12 @@ reports `True`.
 
 Crossplane calls a Function to determine what resources it should create when
 you create a composite resource. The Function also tells Crossplane what to do
-with these resources when you update or delete a composite resource.
+with these resources when you update a composite resource.
+
+{{<hint "note" >}}
+Composition functions don't run when you delete a composite resource.
+Crossplane handles deletion of composed resources automatically.
+{{< /hint >}}
 
 When Crossplane calls a Function it sends it the current state of the composite
 resource. It also sends it the current state of any resources the composite
@@ -576,7 +581,7 @@ sequenceDiagram
     Crossplane Pod->>+API Server: Apply desired composed resources
 ```
 
-When you create, update, or delete a composite resource that uses composition
+When you create or update a composite resource that uses composition
 functions Crossplane calls each function in the order they appear in the
 Composition's pipeline. Crossplane calls each function by sending it a gRPC
 RunFunctionRequest. The function must respond with a gRPC RunFunctionResponse.
@@ -769,3 +774,35 @@ that isn't desired state. Functions can use context for this. Any function can
 write to the pipeline context. Crossplane passes the context to all following
 functions. When Crossplane has called all functions it discards the pipeline
 context.
+
+### Function response cache
+
+{{<hint "note" >}}
+Function response caching is an alpha feature. Enable it by setting the 
+`--enable-function-response-cache` feature flag.
+{{< /hint >}}
+
+Crossplane can cache function responses to improve performance by reducing 
+repeated function calls. When enabled, Crossplane caches responses from 
+composition functions that include a time to live (TTL) value.
+
+The cache works by:
+- Storing function responses on disk based on a hash of the request
+- Only caching responses with a nonzero TTL
+- Automatically removing expired cache entries
+- Reusing cached responses for identical requests until they expire
+
+This feature helps functions that:
+- Perform expensive computations or external API calls
+- Return stable results for the same inputs
+- Include appropriate TTL values in their responses
+
+#### Cache configuration
+
+Control the cache behavior with these Crossplane pod arguments:
+
+- `--xfn-cache-max-ttl` - Maximum cache duration (default: 24 hours)
+
+The cache stores files in the `/cache/xfn/` directory in the Crossplane pod.
+For better performance, consider using an in-memory cache by mounting an 
+emptyDir volume with `medium: Memory`.

content/v2.0/composition/environment-configs.md

@@ -4,7 +4,7 @@ weight: 75
 state: beta
 alphaVersion: "1.11"
 betaVersion: "1.18"
-description: "Environment Configs or EnvironmentConfigs are an in-memory datastore used in Compositions"
+description: "In-memory data stores for Compositions"
 ---
 
 <!--

content/v2.0/get-started/_index.md

@@ -4,3 +4,4 @@ weight: 40
 description: Get started with Crossplane.
 ---
 
+{{< auto-index >}}

content/v2.0/get-started/get-started-with-composition.md

@@ -1,6 +1,7 @@
 ---
 title: Get Started With Composition
 weight: 200
+description: "Build custom APIs with Crossplane composition"
 ---
 
 This guide shows how to create a new kind of custom resource named `App`. When a

content/v2.0/get-started/get-started-with-managed-resources.md

@@ -1,6 +1,7 @@
 ---
 title: Get Started With Managed Resources
 weight: 300
+description: "Manage cloud resources in Kubernetes with Crossplane providers"
 ---
 
 This guide shows how to install and use a new kind of custom resource called