From 397483c8296ed1819741ad689525a779c7fe1d72 Mon Sep 17 00:00:00 2001
From: Gloria <wusongqing@huawei.com>
Date: Mon, 14 Nov 2022 19:59:18 +0800
Subject: [PATCH] Update docs against 10661

Signed-off-by: wusongqing<wusongqing@huawei.com>
---
 .../v3.1-Release/changelog-v3.1-release.md    | 56 +++++++++++++++++++
 .../api-change/v3.1-Release/readme.md         |  1 +
 en/website.md                                 |  1 +
 3 files changed, 58 insertions(+)
 create mode 100644 en/release-notes/api-change/v3.1-Release/changelog-v3.1-release.md

diff --git a/en/release-notes/api-change/v3.1-Release/changelog-v3.1-release.md b/en/release-notes/api-change/v3.1-Release/changelog-v3.1-release.md
new file mode 100644
index 0000000000..597bda22e9
--- /dev/null
+++ b/en/release-notes/api-change/v3.1-Release/changelog-v3.1-release.md
@@ -0,0 +1,56 @@
+# Updates (OpenHarmony 3.1 Beta -> OpenHarmony 3.1 Release)
+
+### Added Validity Verification for Color Values in Color.json
+
+Validity verification is added for color values in the **color.json** file. The verification rules are as follows:
+
+- The hexadecimal color code is used in any of the following formats:
+    - #rgb: red(0-f) green(0-f) blue(0-f)
+    - #argb: transparency(0-f) red(0-f) green(0-f) blue(0-f)
+    - #rrggbb: red(00-ff) green(00-ff) blue(00-ff)
+    - #aarrggbb: transparency(00-ff) red(00-ff) green(00-ff) blue(00-ff)
+- The dollar sign ($) is used to reference resources defined in the application. The format is as follows:
+    - $color:xxx
+
+**Change Impacts**
+
+If the verification rules are not met, an error is reported during compilation.
+
+**Key API/Component Changes**
+
+None
+
+### Restrictions on Declaring Multiple Data Types of State Variables
+
+If a **@State**, **@Provide**, **@Link**, or **@Consume** decorated state variable supports multiple data types, they must be all simple data types or references at one time.
+
+Example:
+
+```ts
+@Entry
+@Component
+struct Index {
+  // Incorrect: @State message: string | Resource = 'Hello World'
+  @State message: string = 'Hello World'
+
+  build() {
+    Row() {
+      Column() {
+        Text(`${ this.message }`)
+          .fontSize(50)
+          .fontWeight(FontWeight.Bold)
+      }
+      .width('100%')
+    }
+    .height('100%')
+  }
+}
+```
+
+**Change Impacts**
+
+When the defined state variable type contains both the simple data types and references, an error is reported during compilation.
+
+**Key API/Component Changes**
+
+If the defined state variable type contains both the simple data types and references, change the type to one of them, as shown in the preceding sample code.
diff --git a/en/release-notes/api-change/v3.1-Release/readme.md b/en/release-notes/api-change/v3.1-Release/readme.md
index d84adb9e93..e7465982e3 100644
--- a/en/release-notes/api-change/v3.1-Release/readme.md
+++ b/en/release-notes/api-change/v3.1-Release/readme.md
@@ -4,3 +4,4 @@ This directory records the API changes in OpenHarmony 3.1 Release over OpenHarmo
 
 - [JS API Differences](js-apidiff-v3.1-release.md)
 - [Native API Differences](native-apidiff-v3.1-release.md)
+- [Updates (OpenHarmony 3.1 Beta -> OpenHarmony 3.1 Release)](changelog-v3.1-release.md)
diff --git a/en/website.md b/en/website.md
index 7550ac898e..7e6d8f34ec 100644
--- a/en/website.md
+++ b/en/website.md
@@ -52,6 +52,7 @@
         - [User IAM subsystem](release-notes/api-change/v3.1-Release/js-apidiff-user-authentication.md)
         - [Window manager subsystem](release-notes/api-change/v3.1-Release/js-apidiff-window.md)
       - [Native API Differences](release-notes/api-change/v3.1-Release/native-apidiff-v3.1-release.md)
+      - [Updates (OpenHarmony 3.1 Beta -> OpenHarmony 3.1 Release)](release-notes/api-change/v3.1-Release/changelog-v3.1-release.md)      
 - Contribution
   - [How to Contribute](contribute/how-to-contribute.md)
   - [Code of Conduct](contribute/code-of-conduct.md)
-- 
GitLab