提交 7d1a0d41 编写于 作者: W wusongqing

update docs against 7725

Signed-off-by: Nwusongqing <wusongqing@huawei.com>
上级 c2f0d634
# ChangeLog # *Example* Subsystem ChangeLog
## *Example* Subsystem (Do not modify or delete this example)
Changes that affect contract compatibility of a released version should be described in the ChangeLog. The changes include but are not limited to those related to API names, parameters, return values, required permissions, call sequence, enumerated values, configuration parameters, and paths. Contract compatibility, also called semantic compatibility, means that the original program behavior should remain consistent over versions. Changes that affect contract compatibility of the last version should be described in the ChangeLog. The changes include but are not limited to those related to API names, parameters, return values, required permissions, call sequence, enumerated values, configuration parameters, and paths. The last version can be an LTS, release, beta, or monthly version, or the like. Contract compatibility, also called semantic compatibility, means that the original program behavior should remain consistent over versions.
### cl.subsystemname.x xxx Function Change (Example: DeviceType Attribute Change or Camera Permission Change. Use a short description.)
Add the number **cl.*subsystemname*.*x*** before each change title, where **cl** is the abbreviation of ChangeLog, *subsystemname* is the standard English name of the subsystem, and *x* indicates the change sequence number (in ascending order). ## cl.subsystemname.x xxx Function Change (Example: DeviceType Attribute Change or Camera Permission Change. Use a short description.)
Add the number **cl.*subsystemname*.*x*** before each change title, where **cl** is the abbreviation of ChangeLog, *subsystemname* is the standard English name of the subsystem, and *x* indicates the change sequence number (starting from 1 in ascending order).
Describe the changes in terms of functions. Example: *n* and *m* of the *a* function are changed. Developers need to adapt their applications based on the change description. Describe the changes in terms of functions. Example: *n* and *m* of the *a* function are changed. Developers need to adapt their applications based on the change description.
If there is a requirement or design document corresponding to the change, attach the requirement number or design document number in the description. If there is a requirement or design document corresponding to the change, attach the requirement number or design document number in the description.
**Change Impact** **Change Impact**
Describe whether released APIs (JS, Java, or native APIs) are affected or API behavior is changed. Describe whether released APIs (JS or native APIs) are affected or API behavior is changed.
Describe whether available applications are affected, that is, whether an adaptation is required for building the application code in the SDK environment of the new version.
**Key API/Component Changes** **Key API/Component Changes**
...@@ -16,13 +19,10 @@ List the API/component changes involved in the function change. ...@@ -16,13 +19,10 @@ List the API/component changes involved in the function change.
**Adaptation Guide (Optional)** **Adaptation Guide (Optional)**
Provide guidance for developers on how to adapt their application to the changes to be compatible with the new version. Example: Provide guidance for developers on how to adapt their application to the changes to be compatible with the new version.
Example:
Change parameter *n* to *m* in the *a* file. Change parameter *n* to *m* in the *a* file.
``` ```
sample code sample code
``` ```
### cl.subsystemname.x xxx Function Change
If a subsystem introduces any function changes, include a standalone section in the subsystem chapter to describe the function changes.
## *Example* Subsystem
Each subsystem has only one such chapter.
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册