docs: update kubernetes tool integration documents

Signed-off-by: peefy <[email protected]>

Author: Peefy

docs/user_docs/guides/working-with-k8s/3-mutate-manifests/1-kubectl-kcl-plugin.md

@@ -195,9 +195,11 @@ Ingress should be https. The `kubernetes.io/ingress.allow-http: "false"` annotat
 
 Here's what you can do in the KCL code:
 
-- Read resources from `option("resource_list")`. The `option("resource_list")` complies with the [KRM Functions Specification](https://kpt.dev/book/05-developing-functions/01-functions-specification). You can read the input resources from `option("resource_list")["items"]` and the `functionConfig` from `option("resource_list")["functionConfig"]`.
+- Read resources from `option("items")`. The `option("items")` complies with the [KRM Functions Specification](https://kpt.dev/book/05-developing-functions/01-functions-specification).
 - Return a KRM list for output resources.
 - Return an error using `assert {condition}, {error_message}`.
+- Read the PATH variables. e.g. `option("PATH")`.
+- Read the environment variables. e.g. `option("env")`.
 
 ## More Resources
 

docs/user_docs/guides/working-with-k8s/3-mutate-manifests/2-helm-kcl-plugin.md

@@ -91,9 +91,11 @@ spec:
 
 Here's what you can do in the KCL code:
 
-- Read resources from `option("resource_list")`. The `option("resource_list")` complies with the [KRM Functions Specification](https://kpt.dev/book/05-developing-functions/01-functions-specification). You can read the input resources from `option("resource_list")["items"]` and the `functionConfig` from `option("resource_list")["functionConfig"]`.
+- Read resources from `option("items")`. The `option("items")` complies with the [KRM Functions Specification](https://kpt.dev/book/05-developing-functions/01-functions-specification).
 - Return a KRM list for output resources.
 - Return an error using `assert {condition}, {error_message}`.
+- Read the PATH variables. e.g. `option("PATH")`.
+- Read the environment variables. e.g. `option("env")`.
 
 ## More Documents and Examples
 

docs/user_docs/guides/working-with-k8s/3-mutate-manifests/3-kustomize-kcl-plugin.md

@@ -96,9 +96,11 @@ spec:
 
 Here's what you can do in the KCL code:
 
-- Read resources from `option("resource_list")`. The `option("resource_list")` complies with the [KRM Functions Specification](https://kpt.dev/book/05-developing-functions/01-functions-specification). You can read the input resources from `option("resource_list")["items"]` and the `functionConfig` from `option("resource_list")["functionConfig"]`.
+- Read resources from `option("items")`. The `option("items")` complies with the [KRM Functions Specification](https://kpt.dev/book/05-developing-functions/01-functions-specification).
 - Return a KRM list for output resources.
 - Return an error using `assert {condition}, {error_message}`.
+- Read the PATH variables. e.g. `option("PATH")`.
+- Read the environment variables. e.g. `option("env")`.
 
 ## More Documents and Examples
 

docs/user_docs/guides/working-with-k8s/3-mutate-manifests/4-kpt-kcl-sdk.md

@@ -87,9 +87,11 @@ It can be seen that we have indeed added the annotation `managed-by=kpt`.
 
 Here's what you can do in the KCL code:
 
-- Read resources from `option("resource_list")`. The `option("resource_list")` complies with the [KRM Functions Specification](https://kpt.dev/book/05-developing-functions/01-functions-specification). You can read the input resources from `option("resource_list")["items"]` and the `functionConfig` from `option("resource_list")["functionConfig"]`.
+- Read resources from `option("items")`. The `option("items")` complies with the [KRM Functions Specification](https://kpt.dev/book/05-developing-functions/01-functions-specification).
 - Return a KRM list for output resources.
 - Return an error using `assert {condition}, {error_message}`.
+- Read the PATH variables. e.g. `option("PATH")`.
+- Read the environment variables. e.g. `option("env")`.
 
 ## More Documents and Examples
 

docs/user_docs/guides/working-with-k8s/3-mutate-manifests/5-helmfile-kcl-plugin.md

@@ -104,9 +104,11 @@ Adding repo prometheus-community https://prometheus-community.github.io/helm-cha
 
 Here's what you can do in the KCL code:
 
-- Read resources from `option("resource_list")`. The `option("resource_list")` complies with the [KRM Functions Specification](https://kpt.dev/book/05-developing-functions/01-functions-specification). You can read the input resources from `option("resource_list")["items"]` and the `functionConfig` from `option("resource_list")["functionConfig"]`.
+- Read resources from `option("items")`. The `option("items")` complies with the [KRM Functions Specification](https://kpt.dev/book/05-developing-functions/01-functions-specification).
 - Return a KRM list for output resources.
 - Return an error using `assert {condition}, {error_message}`.
+- Read the PATH variables. e.g. `option("PATH")`.
+- Read the environment variables. e.g. `option("env")`.
 
 ## More Documents and Examples
 

docs/user_docs/guides/working-with-k8s/3-mutate-manifests/6-kcl-operator.md

@@ -83,9 +83,11 @@ The output is
 
 Here's what you can do in the KCL code:
 
-- Read resources from `option("resource_list")`. The `option("resource_list")` complies with the [KRM Functions Specification](https://kpt.dev/book/05-developing-functions/01-functions-specification). You can read the input resources from `option("items")` and the params from `option("params")`.
+- Read resources from `option("items")`. The `option("items")` complies with the [KRM Functions Specification](https://kpt.dev/book/05-developing-functions/01-functions-specification).
 - Return a KRM list for output resources.
 - Return an error using `assert {condition}, {error_message}`.
+- Read the PATH variables. e.g. `option("PATH")`.
+- Read the environment variables. e.g. `option("env")`.
 
 ## More Documents and Examples
 

docs/user_docs/guides/working-with-k8s/3-mutate-manifests/7-crossplane-kcl-function.md

@@ -221,18 +221,20 @@ spec:
 
 Here's what you can do in the KCL script:
 
-- Return an error using `assert {condition}, {error_message}`.
 - Read the `ObservedCompositeResource` from `option("params").oxr`.
 - Read the `ObservedComposedResources` from `option("params").ocds`.
 - Read the `DesiredCompositeResource` from `option("params").dxr`.
 - Read the `DesiredComposedResources` from `option("params").dcds`.
-- Read the environment variables. e.g. `option("PATH")` (**Not yet implemented**).
+- Read the function pipeline's context from `option("params").ctx`.
+- Return an error using `assert {condition}, {error_message}`.
+- Read the PATH variables. e.g. `option("PATH")`.
+- Read the environment variables. e.g. `option("env")`.
 
 ## Library
 
 You can directly use [KCL standard libraries](https://kcl-lang.io/docs/reference/model/overview) such as `regex.match`, `math.log`.
 
 ## More Documents and Examples
 
+- [Crossplane KCL](https://github.com/crossplane-contrib/function-kcl/)
 - [KRM KCL Spec](https://github.com/kcl-lang/krm-kcl)
-- [Crossplane KCL](https://github.com/crossplane-contrib/function-kcl/examples)

i18n/zh-CN/docusaurus-plugin-content-docs/current/user_docs/guides/working-with-k8s/3-mutate-manifests/1-kubectl-kcl-plugin.md

@@ -195,9 +195,11 @@ Ingress should be https. The `kubernetes.io/ingress.allow-http: "false"` annotat
 
 Here's what you can do in the KCL code:
 
-- Read resources from `option("resource_list")`. The `option("resource_list")` complies with the [KRM Functions Specification](https://kpt.dev/book/05-developing-functions/01-functions-specification). You can read the input resources from `option("resource_list")["items"]` and the `functionConfig` from `option("resource_list")["functionConfig"]`.
+- Read resources from `option("items")`. The `option("items")` complies with the [KRM Functions Specification](https://kpt.dev/book/05-developing-functions/01-functions-specification).
 - Return a KRM list for output resources.
 - Return an error using `assert {condition}, {error_message}`.
+- Read the PATH variables. e.g. `option("PATH")`.
+- Read the environment variables. e.g. `option("env")`.
 
 ## More Resources