Update docs (18105)

Signed-off-by: Nester.zhou <ester.zhou@huawei.com>

en/application-dev/reference/apis/js-apis-enterprise-dateTimeManager.md

@@ -16,7 +16,7 @@ import dateTimeManager from '@ohos.enterprise.dateTimeManager'
 
 setDateTime(admin: Want, time: number, callback: AsyncCallback\<void>): void
 
-Sets the system time. This API uses an asynchronous callback to return the result.
+Configures a device administrator application to set the system time. This API uses an asynchronous callback to return the result.
 
 **Required permissions**: ohos.permission.ENTERPRISE_SET_DATETIME
 
@@ -59,7 +59,7 @@ dateTimeManager.setDateTime(wantTemp, 1526003846000, (error) => {
 
 setDateTime(admin: Want, time: number): Promise\<void>
 
-Sets the system time. This API uses a promise to return the result.
+Configures a device administrator application to set the system time. This API uses a promise to return the result.
 
 **Required permissions**: ohos.permission.ENTERPRISE_SET_DATETIME
 
@@ -106,7 +106,7 @@ dateTimeManager.setDateTime(wantTemp, 1526003846000).then(() => {
 
 disallowModifyDateTime(admin: Want, disallow: boolean, callback: AsyncCallback\<void>): void
 
-Disables modification of the system time. This API uses an asynchronous callback to return the result.
+Configures a device administrator application to disable modification of the system time. This API uses an asynchronous callback to return the result.
 
 **Required permissions**: ohos.permission.ENTERPRISE_SET_DATETIME
 
@@ -149,7 +149,7 @@ dateTimeManager.disallowModifyDateTime(wantTemp, true, (error) => {
 
 disallowModifyDateTime(admin: Want, disallow: boolean): Promise\<void>
 
-Disables modification of the system time. This API uses a promise to return the result.
+Configures a device administrator application to disable modification of the system time. This API uses a promise to return the result.
 
 **Required permissions**: ohos.permission.ENTERPRISE_SET_DATETIME
 
@@ -196,7 +196,7 @@ dateTimeManager.disallowModifyDateTime(wantTemp, true).then(() => {
 
 isModifyDateTimeDisallowed(admin: Want, callback: AsyncCallback\<boolean>): void
 
-Checks whether modification of the system time is disabled. This API uses an asynchronous callback to return the result.
+Configures a device administrator application to check whether modification of the system time is disabled. This API uses an asynchronous callback to return the result.
 
 **Required permissions**: ohos.permission.ENTERPRISE_SET_DATETIME
 
@@ -238,7 +238,7 @@ dateTimeManager.isModifyDateTimeDisallowed(wantTemp, (error) => {
 
 isModifyDateTimeDisallowed(admin: Want): Promise\<boolean>
 
-Checks whether modification of the system time is disabled. This API uses a promise to return the result.
+Configures a device administrator application to check whether modification of the system time is disabled. This API uses a promise to return the result.
 
 **Required permissions**: ohos.permission.ENTERPRISE_SET_DATETIME
 
@@ -256,7 +256,7 @@ Checks whether modification of the system time is disabled. This API uses a prom
 
 | Type  | Description                                 |
 | ----- | ----------------------------------- |
-| Promise\<boolean> | Promise Promise used to return the result. The value **true** means that modification of the system time is disabled, and **false** means the opposite.|
+| Promise\<boolean> | Promise used to return the result. The value **true** means that modification of the system time is disabled, and **false** means the opposite.|
 
 **Error codes**
 

en/application-dev/reference/apis/js-apis-enterprise-deviceInfo.md

@@ -16,7 +16,7 @@ import deviceInfo from '@ohos.enterprise.deviceInfo';
 
 getDeviceSerial(admin: Want, callback: AsyncCallback<string>): void
 
-Obtains the device serial number. This API uses an asynchronous callback to return the result.
+Configures a device administrator application to obtain the device serial number. This API uses an asynchronous callback to return the result.
 
 **Required permissions**: ohos.permission.ENTERPRISE_GET_DEVICE_INFO
 
@@ -29,13 +29,13 @@ Obtains the device serial number. This API uses an asynchronous callback to retu
 | Name     | Type                                      | Mandatory  | Description                      |
 | -------- | ---------------------------------------- | ---- | ------------------------------- |
 | admin    | [Want](js-apis-app-ability-want.md)     | Yes   | Device administrator application.                 |
-| callback | AsyncCallback<string>            | Yes   | Callback used to return the device serial number.      |
+| callback | AsyncCallback&lt;string&gt;            | Yes   | Callback used to return the result.<br> If the operation is successful, **err** is **null** and **data** is the device serial number obtained. If the operation fails, **err** is an error object.      |
 
 **Error codes**
 
 For details about the error codes, see [Enterprise Device Management Error Codes](../errorcodes/errorcode-enterpriseDeviceManager.md).
 
-| ID| Error Message                                                                      |
+| ID| Error Message                                                                      |          
 | ------- | ---------------------------------------------------------------------------- |
 | 9200001 | the application is not an administrator of the device.                        |
 | 9200002 | the administrator application does not have permission to manage the device. |
@@ -60,7 +60,7 @@ deviceInfo.getDeviceSerial(wantTemp, (error, result) => {
 
 getDeviceSerial(admin: Want): Promise&lt;string&gt;
 
-Obtains the device serial number. This API uses a promise to return the result.
+Configures a device administrator application to obtain the device serial number. This API uses a promise to return the result.
 
 **Required permissions**: ohos.permission.ENTERPRISE_GET_DEVICE_INFO
 
@@ -84,7 +84,7 @@ Obtains the device serial number. This API uses a promise to return the result.
 
 For details about the error codes, see [Enterprise Device Management Error Codes](../errorcodes/errorcode-enterpriseDeviceManager.md).
 
-| ID| Error Message                                                                    |
+| ID| Error Message                                                                    |          
 | ------- | ---------------------------------------------------------------------------- |
 | 9200001 | the application is not an administrator of the device.                        |
 | 9200002 | the administrator application does not have permission to manage the device. |
@@ -107,7 +107,7 @@ deviceInfo.getDeviceSerial(wantTemp).then((result) => {
 
 getDisplayVersion(admin: Want, callback: AsyncCallback&lt;string&gt;): void;
 
-Obtains the device version number. This API uses an asynchronous callback to return the result.
+Configures a device administrator application to obtain the device version number. This API uses an asynchronous callback to return the result.
 
 **Required permissions**: ohos.permission.ENTERPRISE_GET_DEVICE_INFO
 
@@ -120,13 +120,13 @@ Obtains the device version number. This API uses an asynchronous callback to ret
 | Name     | Type                                      | Mandatory  | Description                      |
 | -------- | ---------------------------------------- | ---- | ------------------------------- |
 | admin    | [Want](js-apis-app-ability-want.md)      | Yes   | Device administrator application.                 |
-| callback | AsyncCallback&lt;string&gt;            | Yes   | Callback used to return the device version number.      |
+| callback | AsyncCallback&lt;string&gt;            | Yes   | Callback used to return the result.<br> If the operation is successful, **err** is **null** and **data** is the device version number obtained. If the operation fails, **err** is an error object.      |
 
 **Error codes**
 
 For details about the error codes, see [Enterprise Device Management Error Codes](../errorcodes/errorcode-enterpriseDeviceManager.md).
 
-| ID| Error Message                                                                      |
+| ID| Error Message                                                                      |          
 | ------- | ---------------------------------------------------------------------------- |
 | 9200001 | the application is not an administrator of the device.                        |
 | 9200002 | the administrator application does not have permission to manage the device. |
@@ -151,7 +151,7 @@ deviceInfo.getDisplayVersion(wantTemp, (error, result) => {
 
 getDisplayVersion(admin: Want): Promise&lt;string&gt;
 
-Obtains the device version number. This API uses a promise to return the result.
+Configures a device administrator application to obtain the device version number. This API uses a promise to return the result.
 
 **Required permissions**: ohos.permission.ENTERPRISE_GET_DEVICE_INFO
 
@@ -169,13 +169,13 @@ Obtains the device version number. This API uses a promise to return the result.
 
 | Type                  | Description                     |
 | --------------------- | ------------------------- |
-| Promise&lt;string&gt; | Promise used to return the device version number. |
+| Promise&lt;string&gt; | Promise used to return the device version number.|
 
 **Error codes**
 
 For details about the error codes, see [Enterprise Device Management Error Codes](../errorcodes/errorcode-enterpriseDeviceManager.md).
 
-| ID| Error Message                                                                    |
+| ID| Error Message                                                                    |          
 | ------- | ---------------------------------------------------------------------------- |
 | 9200001 | the application is not an administrator of the device.                        |
 | 9200002 | the administrator application does not have permission to manage the device. |
@@ -198,7 +198,7 @@ deviceInfo.getDisplayVersion(wantTemp).then((result) => {
 
 getDeviceName(admin: Want, callback: AsyncCallback&lt;string&gt;): void
 
-Obtains the device name. This API uses an asynchronous callback to return the result.
+Configures a device administrator application to obtain the device name. This API uses an asynchronous callback to return the result.
 
 **Required permissions**: ohos.permission.ENTERPRISE_GET_DEVICE_INFO
 
@@ -211,13 +211,13 @@ Obtains the device name. This API uses an asynchronous callback to return the re
 | Name     | Type                                      | Mandatory  | Description                      |
 | -------- | ---------------------------------------- | ---- | ------------------------------- |
 | admin    | [Want](js-apis-app-ability-want.md)      | Yes   | Device administrator application.                 |
-| callback | AsyncCallback&lt;string&gt;              | Yes   | Callback used to return the device name.      |
+| callback | AsyncCallback&lt;string&gt;              | Yes   | Callback used to return the result.<br> If the operation is successful, **err** is **null** and **data** is the device name obtained. If the operation fails, **err** is an error object.      |
 
 **Error codes**
 
 For details about the error codes, see [Enterprise Device Management Error Codes](../errorcodes/errorcode-enterpriseDeviceManager.md).
 
-| ID| Error Message                                                                      |
+| ID| Error Message                                                                      |          
 | ------- | ---------------------------------------------------------------------------- |
 | 9200001 | the application is not an administrator of the device.                        |
 | 9200002 | the administrator application does not have permission to manage the device. |
@@ -242,7 +242,7 @@ deviceInfo.getDeviceName(wantTemp, (error, result) => {
 
 getDeviceName(admin: Want): Promise&lt;string&gt;
 
-Obtains the device name. This API uses a promise to return the result.
+Configures a device administrator application to obtain the device name. This API uses a promise to return the result.
 
 **Required permissions**: ohos.permission.ENTERPRISE_GET_DEVICE_INFO
 
@@ -260,13 +260,13 @@ Obtains the device name. This API uses a promise to return the result.
 
 | Type                  | Description                     |
 | --------------------- | ------------------------- |
-| Promise&lt;string&gt; | Promise used to return the device name. |
+| Promise&lt;string&gt; | Promise used to return the device name.|
 
 **Error codes**
 
 For details about the error codes, see [Enterprise Device Management Error Codes](../errorcodes/errorcode-enterpriseDeviceManager.md).
 
-| ID| Error Message                                                                    |
+| ID| Error Message                                                                    |          
 | ------- | ---------------------------------------------------------------------------- |
 | 9200001 | the application is not an administrator of the device.                        |
 | 9200002 | the administrator application does not have permission to manage the device. |

en/application-dev/reference/apis/js-apis-plugincomponent.md

@@ -55,8 +55,8 @@ Sets the parameters to be passed in the **PluginManager.Push** API in the FA mod
 | --------- | ----------------------------------- | ---- | -------------------------------------------------------------- |
 | want      | [Want](js-apis-application-want.md) | Yes  | Ability information of the component user.                                       |
 | name      | string                              | Yes  | Component name.                                                    |
-| data      | [KVObject](#kvobject)               | No  | Component data value.                                                  |
-| extraData | [KVObject](#kvobject)               | No  | Additional data value.                                                  |
+| data      | [KVObject](#kvobject)               | Yes  | Component data value.                                                  |
+| extraData | [KVObject](#kvobject)               | Yes  | Additional data value.                                                  |
 | jsonPath  | string                              | No  | Path to the [external.json](#about-the-externaljson-file) file that stores the template path.|
 
 ### PushParameterForStage
@@ -74,8 +74,8 @@ Sets the parameters to be passed in the **PluginManager.Push** API in the stage
 | owner     | [Want](js-apis-application-want.md) | Yes  | Ability information of the component provider.                                         |
 | target    | [Want](js-apis-application-want.md) | Yes  | Ability information of the component user.                                         |
 | name      | string                              | Yes  | Component name.                                                      |
-| data      | [KVObject](#kvobject)               | No  | Component data value.                                                    |
-| extraData | [KVObject](#kvobject)               | No  | Additional data value.                                                    |
+| data      | [KVObject](#kvobject)               | Yes  | Component data value.                                                    |
+| extraData | [KVObject](#kvobject)               | Yes  | Additional data value.                                                    |
 | jsonPath  | string                              | No  | Path to the [external.json](#about-the-externaljson-file) file that stores the template path.|
 
 ### RequestParameters
@@ -117,11 +117,11 @@ Provides the result returned after the **PluginManager.Request** API is called.
 
 **System capability**: SystemCapability.ArkUI.ArkUI.Full
 
-| Name             | Type                                                | Mandatory| Description      |
-| ----------------- | ---------------------------------------------------- | ---- | ---------- |
-| componentTemplate | [PluginComponentTemplate](#plugincomponenttemplate)] | Yes  | Component template.|
-| data              | [KVObject](#kvobject)                                | Yes  | Component data.|
-| extraData         | [KVObject](#kvobject)                                | Yes  | Additional data.|
+| Name             | Type                                               | Mandatory| Description      |
+| ----------------- | --------------------------------------------------- | ---- | ---------- |
+| componentTemplate | [PluginComponentTemplate](#plugincomponenttemplate) | Yes  | Component template.|
+| data              | [KVObject](#kvobject)                               | Yes  | Component data.|
+| extraData         | [KVObject](#kvobject)                               | Yes  | Additional data.|
 
 ### RequestEventResult
 
@@ -175,7 +175,7 @@ Registers the listener for the request event.
 | Name     | Type                               | Mandatory| Description                       |
 | --------- | ----------------------------------- | ---- | --------------------------- |
 | source    | [Want](js-apis-application-want.md) | Yes  | Information about the request sender.|
-| data      | [KVObject](#kvobject)               | Yes  | Data.                     |
+| name      | string                              | Yes  | Template name.                 |
 | extraData | [KVObject](#kvobject)               | Yes  | Additional data.                 |
 
 **Example**

en/application-dev/reference/arkui-ts/ts-basic-components-plugincomponent.md

@@ -5,7 +5,7 @@ The **\<PluginComponent>** allows the UI provided by an external application to
 
 >  **NOTE**
 >
-> - This component is supported since API version 9. Updates will be marked with a superscript to indicate their earliest API version.
+> This component is supported since API version 9. Updates will be marked with a superscript to indicate their earliest API version.
 
 ## Child Components
 
@@ -30,10 +30,21 @@ Creates a **PluginComponent** to display the UI provided by an external applicat
 | ---------- | ------ | --------------------------- |
 | source     | string | Component template name.               |
 | bundleName | string | Bundle name of the provider ability.|
-
 ## Attributes
+The [universal attributes](ts-universal-attributes-size.md) are supported, and **size** must be set.
+
+**NOTE**
+
+  The template can be provided in either of the following modes:
+* Use an absolute path. In this case, set **source** to the absolute path of the template and leave **bundleName** blank. This mode is not recommende as it is applicable only to standalone templates that do not need to load resources.
+* Use an application package. In this case, set **bundleName** to the application bundle name and **source** to the relative path of the HAP file template. In the multi-HAP scenario, a HAP file is identified based on its relative path and name.
+
+  Example: **{source: 'ets/pages/plugin.js&plugin', bundleName:'com.example.provider'}**
+
+  The template is provided only when **source** can be set to an ability name in the FA model.
+
+  Example: **{source:'plugin', bundleName:'com.example.provider'}**
 
-The universal attribute [size](ts-universal-attributes-size.md) is supported and must be set.
 
 ## Events
 

en/application-dev/reference/arkui-ts/ts-types.md

@@ -124,8 +124,8 @@ The **ResourceColor** type is used to describe the color types of resources.
 | Type                                     | Description                                            |
 | ---------------------------------------- | ------------------------------------------------- |
 | [Color](ts-appendix-enums.md#color)      | Color enums.                                      |
-| number                                   | Color in hexadecimal notation. RGB is supported.                                     |
-| string                                   | Color in RGB or ARGB notation.                             |
+| number                                   | Color in hexadecimal notation. RGB is supported. Example: **0xffffff**                                     |
+| string                                   | Color in RGB or ARGB notation. Example: **'#ffffff', '#ff000000', 'rgb(255, 100, 255)', 'rgba(255, 100, 255, 0.5)'**                             |
 | [Resource](#resource)                    | Color referenced from system or application resources.|
 
 ## ColoringStrategy
@@ -215,7 +215,7 @@ The **ColorFilter** type is used to create a color filter with a 4 x 5 matrix.
 
 | Name         | Type      | Mandatory  | Description                                      |
 | ----------- | -------- | ---- | ---------------------------------------- |
-| constructor | number[] | Yes   | Constructor for creating a color filter with a 4 x 5 matrix. The input parameter is [m*n], which is the matrix value in row m and column n. The matrix is row-first.|
+| constructor | number[] | Yes   | Constructor for creating a color filter with a 4 x 5 matrix. The input parameter is [m*n], which is the matrix value in row m and column n. The value range is [0, 1]. The matrix is row-first.|
 
 
 ## CustomBuilder<sup>8+</sup>
@@ -224,7 +224,7 @@ The **CustomBuilder** type is used to define custom UI descriptions in component
 
 | Name           | Type                  | Description                                      |
 | ------------- | ---------------------- | ---------------------------------------- |
-| CustomBuilder | () =&gt; any | Must be decorated by **@Builder**. For details, see [@Builder](../../quick-start/arkts-dynamic-ui-elememt-building.md#builder).|
+| CustomBuilder | () =&gt; any | Must be decorated by **@Builder**. For details, see [@Builder](../../quick-start/arkts-builder.md).|
 
 ## PixelStretchEffectOptions<sup>10+</sup>