RT-Thread / RT-Thread/rt-thread

[Feature] lwp, dm 等组件需要补充 doxygen 注释 | Add Doxygen Comments for Components

Open
#9,263 2 comments 1 reaction 1 assignee View on GitHub

@unicornx is already working on this.

Since Dec 3, 2024.

good first issue RT-Smart
Dominant language
C
Stars
12.2k
Forks
5.4k
Avg merge
4d 12h
Merged PRs (30d)
40

Description

Describe problem solved by the proposed feature

目前,RT-Thread 中的部分组件(如 lwp, dm) 缺少完整的 Doxygen 注释。这些注释对于开发者理解和使用这些组件非常重要。补充完整的 Doxygen 注释将有助于提升代码的可读性和可维护性,并且有助于新开发者快速上手。

需求:

  • 为 lwp 组件的所有公共接口、数据结构和函数补充详细的 Doxygen 注释。
  • 为 dd2.0 组件的所有公共接口、数据结构和函数补充详细的 Doxygen 注释。

确保注释涵盖以下内容:

  • 功能描述
  • 参数说明
  • 返回值说明
  • 任何异常或特殊情况的处理
  • 遵循 RT-Thread 现有的注释风格和 Doxygen 规范。
Describe your preferred solution

No response

Describe possible alternatives

No response

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.