Update sidebar behavior and documentation

Signed-off-by: Rae Sharp <[email protected]>

Author: tr0njavolta

content/master/cli/_index.md

@@ -4,61 +4,3 @@ title: CLI Reference
 description: "Documentation for the Crossplane command-line interface"
 ---
 
-The Crossplane CLI helps simplify some development and administration aspects of
-Crossplane.
-
-The Crossplane CLI includes:
-* tools to build, install, update and push Crossplane Packages
-* standalone Composition Function testing and rendering without the need to access a Kubernetes cluster running Crossplane
-* troubleshoot Crossplane Compositions, Composite Resources and Managed Resources
-
-## Installing the CLI
-
-The Crossplane CLI is a single standalone binary with no external dependencies.
-
-{{<hint "note" >}}
-Install the Crossplane CLI on a user's computer.
-
-Most Crossplane CLI commands are independent of Kubernetes and
-don't require access to a Crossplane pod.
-{{< /hint >}}
-
-To download the latest version for your CPU architecture with the Crossplane
-install script.
-
-```shell
-curl -sL "https://raw.githubusercontent.com/crossplane/crossplane/main/install.sh" | sh
-```
-
-[The script](https://raw.githubusercontent.com/crossplane/crossplane/main/install.sh)
-detects your CPU architecture and downloads the latest stable release.
-
-{{<expand "Manually install the Crossplane CLI" >}}
-
-If you don't want to run shell script you can manually download a binary from
-the Crossplane releases repository at
-https://releases.crossplane.io/stable/current/bin
-
-{{<hint "important" >}}
-<!-- vale write-good.Passive = NO -->
-The release repository names the CLI `crank`. Download this file.
-<!-- vale write-good.Passive = YES -->
-
-The `crossplane` binary is the Kubernetes Crossplane pod image.
-{{< /hint >}}
-
-Move the binary to a location in your `$PATH`, for example `/usr/local/bin`.
-{{< /expand >}}
-
-### Download other CLI versions
-
-Download different Crossplane CLI versions or different release branches with
-the `XP_CHANNEL` and `XP_VERSION` environmental variables.
-
-By default the CLI installs from the `XP_CHANNEL` named `stable` and the
-`XP_VERSION` of `current`, matching the most recent stable release.
-
-For example, to install CLI version `v1.14.0` add `XP_VERSION=v1.14.0` to the
-download script curl command:
-
-`curl -sL "https://raw.githubusercontent.com/crossplane/crossplane/main/install.sh" | XP_VERSION=v1.14.0 sh`

content/master/cli/cli-installation.md

@@ -0,0 +1,64 @@
+---
+weight: 40
+title: CLI Installation 
+description: "Documentation for the Crossplane command-line interface"
+---
+
+The Crossplane CLI helps simplify some development and administration aspects of
+Crossplane.
+
+The Crossplane CLI includes:
+* tools to build, install, update and push Crossplane Packages
+* standalone Composition Function testing and rendering without the need to access a Kubernetes cluster running Crossplane
+* troubleshoot Crossplane Compositions, Composite Resources and Managed Resources
+
+## Installing the CLI
+
+The Crossplane CLI is a single standalone binary with no external dependencies.
+
+{{<hint "note" >}}
+Install the Crossplane CLI on a user's computer.
+
+Most Crossplane CLI commands are independent of Kubernetes and
+don't require access to a Crossplane pod.
+{{< /hint >}}
+
+To download the latest version for your CPU architecture with the Crossplane
+install script.
+
+```shell
+curl -sL "https://raw.githubusercontent.com/crossplane/crossplane/main/install.sh" | sh
+```
+
+[The script](https://raw.githubusercontent.com/crossplane/crossplane/main/install.sh)
+detects your CPU architecture and downloads the latest stable release.
+
+{{<expand "Manually install the Crossplane CLI" >}}
+
+If you don't want to run shell script you can manually download a binary from
+the Crossplane releases repository at
+https://releases.crossplane.io/stable/current/bin
+
+{{<hint "important" >}}
+<!-- vale write-good.Passive = NO -->
+The release repository names the CLI `crank`. Download this file.
+<!-- vale write-good.Passive = YES -->
+
+The `crossplane` binary is the Kubernetes Crossplane pod image.
+{{< /hint >}}
+
+Move the binary to a location in your `$PATH`, for example `/usr/local/bin`.
+{{< /expand >}}
+
+### Download other CLI versions
+
+Download different Crossplane CLI versions or different release branches with
+the `XP_CHANNEL` and `XP_VERSION` environmental variables.
+
+By default the CLI installs from the `XP_CHANNEL` named `stable` and the
+`XP_VERSION` of `current`, matching the most recent stable release.
+
+For example, to install CLI version `v1.14.0` add `XP_VERSION=v1.14.0` to the
+download script curl command:
+
+`curl -sL "https://raw.githubusercontent.com/crossplane/crossplane/main/install.sh" | XP_VERSION=v1.14.0 sh`

content/master/composition/compositions.md

@@ -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 non-zero TTL
+- Automatically removing expired cache entries
+- Reusing cached responses for identical requests until they expire
+
+This feature is particularly useful for 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 within the Crossplane pod.
+For better performance, consider using an in-memory cache by mounting an 
+emptyDir volume with `medium: Memory`.

content/master/get-started/install.md

@@ -106,8 +106,9 @@ at the table below.
 | --- | --- | --- |
 | Beta | `--enable-deployment-runtime-configs` | Enable support for DeploymentRuntimeConfigs. |
 | Beta | `--enable-usages` | Enable support for Usages. |
-| Alpha | `--enable-realtime-compositions` | Enable support for real time compositions. |
+| Beta | `--enable-realtime-compositions` | Enable support for real time compositions. |
 | Alpha | `--enable-dependency-version-upgrades ` | Enable automatic version upgrades of dependencies when updating packages. |
+| Alpha | `--enable-function-response-cache` | Enable caching of composition function responses to improve performance. |
 | Alpha | `--enable-signature-verification` | Enable support for package signature verification via ImageConfig API. |
 {{< /table >}}
 {{< /expand >}}

content/master/guides/function-patch-and-transform.md

@@ -424,7 +424,7 @@ environment:
   patches:
   - type: ToCompositeFieldPath
     fromFieldPath: tags
-    toFieldPath: metadata.labels[envTag]
+    toFieldPath: status.envTag
   - type: FromCompositeFieldPath
     fromFieldPath: metadata.name
     toFieldPath: newEnvironmentKey
@@ -667,7 +667,12 @@ Composition and use it in a second composed resource in the same Composition.
 {{< /hint >}}
 
 For example, after Crossplane creates a new managed resource, take the value
-`hostedZoneID` and apply it as a `label` in the composite resource.
+`hostedZoneID` and store it in the composite resource's status.
+
+{{< hint "important" >}}
+To patch to composite resource status fields, you must first define the custom 
+status fields in the CompositeResourceDefinition.
+{{< /hint >}}
 
 ```yaml {label="toComposite",copy-lines="9-11"}
 apiVersion: pt.fn.crossplane.io/v1beta1
@@ -683,7 +688,7 @@ resources:
   patches:
     - type: ToCompositeFieldPath
       fromFieldPath: status.atProvider.hostedZoneId
-      toFieldPath: metadata.labels['ZoneID']
+      toFieldPath: status.hostedZoneId
 ```
 
 View the created managed resource to see the
@@ -698,12 +703,14 @@ Status:
     # Removed for brevity
 ```
 
-Next view the composite resource and confirm the patch applied the `label`
+Next view the composite resource and confirm the patch applied to the status
 
 ```yaml {label="toCompositeXR",copy-lines="none"}
 $ kubectl describe composite
 Name:         my-example-p5pxf
-Labels:       ZoneID=Z2O1EMRO9K5GLX
+# Removed for brevity
+Status:
+  Hosted Zone Id: Z2O1EMRO9K5GLX
 ```
 
 <!-- vale Google.Headings = NO -->

content/master/guides/pods.md

@@ -137,7 +137,7 @@ Kubernetes API server when a composed resource changes. For example, when
 a provider sets the `Ready` condition to `true`.
 
 {{<hint "important" >}}
-Real time compositions are an alpha feature. Alpha features aren't enabled by
+Real time compositions are a beta feature. Beta features are enabled by
 default. 
 {{< /hint >}}
 

content/master/learn/_index.md

@@ -4,38 +4,3 @@ description: Learn more about Crossplane.
 weight: 500
 ---
 
-If you have any questions, please post in [Crossplane Slack][join-crossplane-slack] or [contact the team][contact-us].
-
-***Learn more about using Crossplane***
- - [Latest Design Docs](https://github.com/crossplane/crossplane/tree/main/design)
- - [Roadmap](https://github.com/crossplane/crossplane/blob/main/ROADMAP.md)
- - [Crossplane Architecture](https://docs.google.com/document/d/1whncqdUeU2cATGEJhHvzXWC9xdK29Er45NJeoemxebo/edit?usp=sharing)
- - [GitLab deploys into multiple clouds from kubectl using Crossplane](https://about.gitlab.com/2019/05/20/gitlab-first-deployed-kubernetes-api-to-multiple-clouds/)
- - [CNCF Talks & Community Presentations](https://www.youtube.com/playlist?list=PL510POnNVaaZJj9OG6PbgsZvgYbhwJRyE)
-<!-- vale write-good.Weasel = NO -->
- - [Software Engineering Daily - Intro Podcast](https://softwareengineeringdaily.com/2019/01/02/crossplane-multicloud-control-plane-with-bassam-tabbara/)
-<!-- vale write-good.Weasel = YES -->
-
-***Writing Kubernetes controllers to extend Crossplane***
- - [Keep the Space Shuttle Flying: Writing Robust Operators](https://www.youtube.com/watch?v=uf97lOApOv8)
- - [Best practices for building Kubernetes Operators](https://cloud.google.com/blog/products/containers-kubernetes/best-practices-for-building-kubernetes-operators-and-stateful-apps)
- - [Programming Kubernetes Book](https://www.oreilly.com/library/view/programming-kubernetes/9781492047094/)
- - [Contributor Guide](https://github.com/crossplane/crossplane/blob/main/CONTRIBUTING.md)
-
-***Join the growing Crossplane community and get involved***
-- Join the [Community Slack](https://slack.crossplane.io/)!
-- Submit an issue on [GitHub](https://github.com/crossplane/crossplane)
-- Attend the biweekly [Community Meeting](https://github.com/crossplane/crossplane#get-involved)
-- Join the biweekly live stream: [The Binding Status](https://github.com/crossplane/tbs)
-- Subscribe to the [YouTube Channel](https://www.youtube.com/channel/UC19FgzMBMqBro361HbE46Fw)
-<!-- vale Crossplane.Spelling = NO -->
-- Follow on Twitter: [@crossplane_io](https://twitter.com/crossplane_io)
-<!-- vale gitlab.SubstitutionWarning = NO -->
-- email: [[email protected]](mailto:[email protected])
-<!-- vale gitlab.SubstitutionWarning = YES -->
-<!-- vale Crossplane.Spelling = YES -->
-
-<!-- Named links -->
-
-[join-crossplane-slack]: https://slack.crossplane.io
-[contact-us]: https://github.com/crossplane/crossplane#contact

content/master/learn/additional-resources.md

@@ -0,0 +1,41 @@
+---
+title: Additional Resources 
+description: Learn more about Crossplane.
+weight: 200
+---
+
+If you have any questions, please post in [Crossplane Slack][join-crossplane-slack] or [contact the team][contact-us].
+
+***Learn more about using Crossplane***
+ - [Latest Design Docs](https://github.com/crossplane/crossplane/tree/main/design)
+ - [Roadmap](https://github.com/crossplane/crossplane/blob/main/ROADMAP.md)
+ - [Crossplane Architecture](https://docs.google.com/document/d/1whncqdUeU2cATGEJhHvzXWC9xdK29Er45NJeoemxebo/edit?usp=sharing)
+ - [GitLab deploys into multiple clouds from kubectl using Crossplane](https://about.gitlab.com/2019/05/20/gitlab-first-deployed-kubernetes-api-to-multiple-clouds/)
+ - [CNCF Talks & Community Presentations](https://www.youtube.com/playlist?list=PL510POnNVaaZJj9OG6PbgsZvgYbhwJRyE)
+<!-- vale write-good.Weasel = NO -->
+ - [Software Engineering Daily - Intro Podcast](https://softwareengineeringdaily.com/2019/01/02/crossplane-multicloud-control-plane-with-bassam-tabbara/)
+<!-- vale write-good.Weasel = YES -->
+
+***Writing Kubernetes controllers to extend Crossplane***
+ - [Keep the Space Shuttle Flying: Writing Robust Operators](https://www.youtube.com/watch?v=uf97lOApOv8)
+ - [Best practices for building Kubernetes Operators](https://cloud.google.com/blog/products/containers-kubernetes/best-practices-for-building-kubernetes-operators-and-stateful-apps)
+ - [Programming Kubernetes Book](https://www.oreilly.com/library/view/programming-kubernetes/9781492047094/)
+ - [Contributor Guide](https://github.com/crossplane/crossplane/blob/main/CONTRIBUTING.md)
+
+***Join the growing Crossplane community and get involved***
+- Join the [Community Slack](https://slack.crossplane.io/)!
+- Submit an issue on [GitHub](https://github.com/crossplane/crossplane)
+- Attend the biweekly [Community Meeting](https://github.com/crossplane/crossplane#get-involved)
+- Join the biweekly live stream: [The Binding Status](https://github.com/crossplane/tbs)
+- Subscribe to the [YouTube Channel](https://www.youtube.com/channel/UC19FgzMBMqBro361HbE46Fw)
+<!-- vale Crossplane.Spelling = NO -->
+- Follow on Twitter: [@crossplane_io](https://twitter.com/crossplane_io)
+<!-- vale gitlab.SubstitutionWarning = NO -->
+- email: [[email protected]](mailto:[email protected])
+<!-- vale gitlab.SubstitutionWarning = YES -->
+<!-- vale Crossplane.Spelling = YES -->
+
+<!-- Named links -->
+
+[join-crossplane-slack]: https://slack.crossplane.io
+[contact-us]: https://github.com/crossplane/crossplane#contact

content/master/operations/operation.md

@@ -297,6 +297,31 @@ For more details on RBAC configuration, see the
 [Compositions RBAC documentation]({{<ref "../composition/compositions#grant-access-to-composed-resources">}}).
 {{</hint>}}
 
+### Function response cache
+
+{{<hint "note" >}}
+Function response caching is an alpha feature. Enable it by setting the 
+`--enable-function-response-cache` feature flag.
+{{< /hint >}}
+
+Operations can benefit from function response caching to improve performance,
+especially for operations that:
+- Call the same functions repeatedly with identical inputs
+- Use functions that perform expensive computations or external API calls
+- Run frequently through CronOperation or WatchOperation
+
+The cache works the same way as for Compositions - function responses with
+time to live values are cached and reused for identical requests until
+they expire.
+
+This is particularly useful for Operations that:
+- Validate configurations using expensive checks
+- Query external systems for status information
+- Perform complex calculations that don't change frequently
+
+For cache configuration details, see the 
+[Function response cache documentation]({{<ref "../composition/compositions#function-response-cache">}}).
+
 ### Required resources
 
 Operations can preload resources for functions to access: