Feat: add reference doc

Signed-off-by: Jianbo Sun <jianbo.sjb@alibaba-inc.com>

docs/contributor/cli-ref-doc.md

@@ -52,6 +52,9 @@ This section introduce how to definition reference docs in the website, includin
 
 Most of the steps are done by script automatically. You need to follow this guide to build your environment.
 
+By default, the following steps will update for all definition reference at a time.
+Just follow these steps.
+
 1. step up these two projects in the same folder.
 
 ```shell
@@ -77,6 +80,99 @@ git status
 
 4. Check in the changes and send pull request.
 
+That's finished for the general update.
+
+### Update for Specific 
+
+You can specify some args for more flexible usage.
+
+* Generate only for specified type
+
+```shell
+go run hack/docgen/def/gen.go --type component
+go run hack/docgen/def/gen.go --type trait
+go run hack/docgen/def/gen.go --type policy
+go run hack/docgen/def/gen.go --type workflowstep
+```
+
+* Specify the path of output
+
+> You must specify a type if path specified.
+
+```shell
+go run hack/docgen/def/gen.go --type component --path ../kubevela.io/docs/end-user/components/references.md
+```
+
+* Specify the i18n location of the output
+
+> You must specify a type if i18n location specified.
+
+```shell
+go run hack/docgen/def/gen.go --location zh --path ../kubevela.io/i18n/zh/docusaurus-plugin-content-docs/current/end-user/components/references.md
+```
+
+### How the docs generated?
+
+1. Load definitions from Kubernetes.
+
+The script will load all definitions from your Kubernetes Cluster, so you need to apply all built-in definitions before run.
+
+2. Compare the internal definition folder in the project.
+
+Besides the server side definitions, the script will also compare the cue files in the KubeVela project. Only definitions existing in these folders will be generated as reference docs.
+
+```console
+$ tree ./vela-templates/definitions/internal
+vela-templates/definitions/internal
+├── component
+│   ├── config-image-registry.cue
+│   ├── ...
+│   └── worker.cue
+├── policy
+│   ├── health.cue
+│   ├── override.cue
+│   └── topology.cue
+├── trait
+│   ├── affinity.cue
+│   ├── ...
+│   └── storage.cue
+└── workflowstep
+    ├── apply-application-in-parallel.cue
+    ├── ...
+    └── webhook.cue
+
+4 directories, 53 files
+```
+
+3. Generate Examples.
+
+By default, the definition don't contain any examples, maintainers can specify example for the built-in definitions.
+
+The docs folder will be embedded into CLI binary, you must write into the following hierarchy:
+
+```console
+$ tree references/plugins/def-doc
+references/plugins/def-doc
+├── component
+│   ├── webservice.eg.md
+│   ├── webservice.param.md
+│   ├── webservice.desc.md
+│   ├── ...
+│   └── worker.eg.md
+└── trait
+    ├── annotations.eg.md
+    ├── ...
+    └── sidecar.eg.md
+
+2 directories, 21 files
+```
+
+The file name **MUST** has the same name with the definition, along with the suffix:
+
+* The example of definition **MUST** has suffix `.eg.md` and write in markdown format.
+* The parameter(specification) of definition **MUST** has suffix `.param.md`, if exists, it will override the one auto-generated from definition parameters.
+* The description of definition **MUST** has suffix `.desc.md`, if exists, it will override the one auto-generated from definition annotation.
+
 
 ## Terraform Based Cloud Resource Reference
 

i18n/zh/docusaurus-plugin-content-docs/current.json

@@ -64,7 +64,7 @@
     "description": "The label for category Managing Applications in sidebar docs"
   },
   "sidebar.docs.category.References": {
-    "message": "参考",
+    "message": "参考手册",
     "description": "The label for category References in sidebar docs"
   },
   "sidebar.docs.category.Learning OAM": {

i18n/zh/docusaurus-plugin-content-docs/version-v1.4.json

@@ -64,7 +64,7 @@
         "description": "The label for category Managing Applications in sidebar docs"
     },
     "sidebar.docs.category.References": {
-        "message": "参考",
+        "message": "参考手册",
         "description": "The label for category References in sidebar docs"
     },
     "sidebar.docs.category.Learning OAM": {