docs: update java sdk documents

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

Author: Peefy

docs/reference/xlang-api/java-api.md

@@ -30,7 +30,7 @@ This way you'll be able to import the above dependency to use the SDK.
 <dependency>
     <groupId>com.kcl</groupId>
     <artifactId>kcl-lib</artifactId>
-    <version>0.8.5</version>
+    <version>0.8.6</version>
 </dependency>
 ```
 

i18n/zh-CN/docusaurus-plugin-content-docs/current/reference/xlang-api/java-api.md

@@ -6,21 +6,45 @@ sidebar_position: 5
 
 ## 添加依赖
 
-```shell
-npm install kcl-lib
-```
+参考[此处](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-apache-maven-registry#authenticating-to-github-packages)来配置您的 Maven；在 settings.xml 中设置您的 GitHub 账户和 Token。
 
 ### Maven
 
-## 快速开始
+在您项目的 pom.xml 中，按如下配置 Maven 仓库：
+
+```xml
+<repositories>
+    <repository>
+        <id>github</id>
+        <url>https://maven.pkg.github.com/kcl-lang/*</url>
+        <snapshots>
+            <enabled>true</enabled>
+        </snapshots>
+    </repository>
+</repositories>
+```
 
-```typescript
-import { execProgram, ExecProgramArgs } from "kcl-lib";
+通过这种方式，您将能够导入上述依赖以使用 Java SDK。
 
-function main() {
-  const result = execProgram(new ExecProgramArgs(["path/to/kcl.k"]));
-  console.log(result.yamlResult);
-}
+```xml
+<dependency>
+    <groupId>com.kcl</groupId>
+    <artifactId>kcl-lib</artifactId>
+    <version>0.8.6</version>
+</dependency>
+```
+
+## 快速开始
 
-main();
+import com.kcl.api.API;
+import com.kcl.api.Spec.ExecProgram_Args;
+import com.kcl.api.Spec.ExecProgram_Result;
+public class ExecProgramTest {
+    public static void main(String[] args) throws Exception {
+        API api = new API();
+        ExecProgram_Result result = api
+                .execProgram(ExecProgram_Args.newBuilder().addKFilenameList("path/to/kcl.k").build());
+        System.out.println(result.getYamlResult());
+    }
+}
 ```

i18n/zh-CN/docusaurus-plugin-content-docs/version-0.8/reference/xlang-api/java-api.md

@@ -6,21 +6,45 @@ sidebar_position: 5
 
 ## 添加依赖
 
-```shell
-npm install kcl-lib
-```
+参考[此处](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-apache-maven-registry#authenticating-to-github-packages)来配置您的 Maven；在 settings.xml 中设置您的 GitHub 账户和 Token。
 
 ### Maven
 
-## 快速开始
+在您项目的 pom.xml 中，按如下配置 Maven 仓库：
+
+```xml
+<repositories>
+    <repository>
+        <id>github</id>
+        <url>https://maven.pkg.github.com/kcl-lang/*</url>
+        <snapshots>
+            <enabled>true</enabled>
+        </snapshots>
+    </repository>
+</repositories>
+```
 
-```typescript
-import { execProgram, ExecProgramArgs } from "kcl-lib";
+通过这种方式，您将能够导入上述依赖以使用 Java SDK。
 
-function main() {
-  const result = execProgram(new ExecProgramArgs(["path/to/kcl.k"]));
-  console.log(result.yamlResult);
-}
+```xml
+<dependency>
+    <groupId>com.kcl</groupId>
+    <artifactId>kcl-lib</artifactId>
+    <version>0.8.6</version>
+</dependency>
+```
+
+## 快速开始
 
-main();
+import com.kcl.api.API;
+import com.kcl.api.Spec.ExecProgram_Args;
+import com.kcl.api.Spec.ExecProgram_Result;
+public class ExecProgramTest {
+    public static void main(String[] args) throws Exception {
+        API api = new API();
+        ExecProgram_Result result = api
+                .execProgram(ExecProgram_Args.newBuilder().addKFilenameList("path/to/kcl.k").build());
+        System.out.println(result.getYamlResult());
+    }
+}
 ```

i18n/zh-CN/docusaurus-plugin-content-docs/version-0.8/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
 

versioned_docs/version-0.8/reference/xlang-api/java-api.md

@@ -30,7 +30,7 @@ This way you'll be able to import the above dependency to use the SDK.
 <dependency>
     <groupId>com.kcl</groupId>
     <artifactId>kcl-lib</artifactId>
-    <version>0.8.5</version>
+    <version>0.8.6</version>
 </dependency>
 ```
 

versioned_docs/version-0.8/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
 

versioned_docs/version-0.8/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
 

versioned_docs/version-0.8/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
 

versioned_docs/version-0.8/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
 

versioned_docs/version-0.8/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
 

versioned_docs/version-0.8/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
 

versioned_docs/version-0.8/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)

versioned_docs/version-0.8/user_docs/support/faq-kcl.md

@@ -2586,3 +2586,16 @@ The command to validate the JSON data below gives the output `Validate success!`
 ```bash
 kcl vet data.json schema.k
 ```
+
+## 63. How can i extend an array's default value in a given schema?
+
+We use the += operator to extend the default values in an array.
+
+```python
+schema MyApp:
+   args: [str] = ["default", "args"]
+
+app = MyApp {
+   args += ["additional", "args"]
+}
+```