Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[认领]: dtk文档标准化 #26

Open
19 of 23 tasks
chenchongbiao opened this issue Nov 30, 2022 · 5 comments
Open
19 of 23 tasks

[认领]: dtk文档标准化 #26

chenchongbiao opened this issue Nov 30, 2022 · 5 comments
Assignees
Labels
可重复认领 此任务可被重复认领 完成验收 已完成所有功能并通过验收 已确认认领 已由任务的联系人确认了任务的认领

Comments

@chenchongbiao
Copy link

chenchongbiao commented Nov 30, 2022

任务描述

dtkcore等dtk模块一直因为文档而诟病,其实这么好的模块它是拥有文档的,但是文档并不符合我们认为的可维护标准,所以我们需要做一件事:在代码内部有且仅有英文注释存在,在代码外部的doc文件夹中书写符合doxygen标准的文档。所以你需要将代码中的中文注释移动到doc文件夹下,最好能够添加英文注释。

验收标准

  • 能提供准确的文档注释(必须满足)
  • 文档修改被合并(必须满足)
  • 在修改文档时发现并修正现有文档中的错误或者其他问题(加分项)
  • 添加或更新文档使用示例(加分项)

相关 PR

联系方式

GitHub:chenchongbiao
邮箱:[email protected]
Matrix:chenchongbiao

@xzl01 xzl01 added the 已确认认领 已由任务的联系人确认了任务的认领 label Nov 30, 2022
@xzl01 xzl01 assigned xzl01 and chenchongbiao and unassigned xzl01 Nov 30, 2022
chenchongbiao added a commit to chenchongbiao/dtkcore that referenced this issue Dec 1, 2022
给dsettings添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
chenchongbiao added a commit to chenchongbiao/dtkcore that referenced this issue Dec 1, 2022
给dsettings添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
deepin-bot bot pushed a commit to linuxdeepin/dtkcore that referenced this issue Dec 1, 2022
给dsettings添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
@chenchongbiao
Copy link
Author

chenchongbiao commented Dec 1, 2022

New Document : 2 changed files with 293 additions and 59 deletions. : linuxdeepin/dtkcore#167

chenchongbiao added a commit to chenchongbiao/dtkcore that referenced this issue Dec 2, 2022
给dsettingsgroup添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
chenchongbiao added a commit to chenchongbiao/dtkcore that referenced this issue Dec 2, 2022
给dsettingsgroup添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
deepin-bot bot pushed a commit to linuxdeepin/dtkcore that referenced this issue Dec 2, 2022
给dsettingsgroup添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
@chenchongbiao
Copy link
Author

New Document : 2 changed files with 98 additions and 44 deletions. : linuxdeepin/dtkcore#174

@BLumia BLumia moved this to 已认领/进行中 in 编程之季 任务进度看板 Dec 2, 2022
chenchongbiao added a commit to chenchongbiao/dtkcore that referenced this issue Dec 2, 2022
给dsettingsoption添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
deepin-bot bot pushed a commit to linuxdeepin/dtkcore that referenced this issue Dec 2, 2022
给dsettingsoption添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
@xzl01 xzl01 added the 可重复认领 此任务可被重复认领 label Dec 2, 2022
chenchongbiao added a commit to chenchongbiao/dtkcore that referenced this issue Dec 3, 2022
给dsettingsdconfigbackend添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
chenchongbiao added a commit to chenchongbiao/dtkcore that referenced this issue Dec 3, 2022
给dsettingsdconfigbackend添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
xzl01 pushed a commit to linuxdeepin/dtkcore that referenced this issue Dec 3, 2022
给dsettingsdconfigbackend添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
chenchongbiao added a commit to chenchongbiao/dtkcore that referenced this issue Dec 3, 2022
给gsettingsbackend添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
chenchongbiao added a commit to chenchongbiao/dtkcore that referenced this issue Dec 3, 2022
给gsettingsbackend添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
chenchongbiao added a commit to chenchongbiao/dtkcore that referenced this issue Dec 3, 2022
给gsettingsbackend添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
chenchongbiao added a commit to chenchongbiao/dtkcore that referenced this issue Dec 4, 2022
给gsettingsbackend添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
xzl01 pushed a commit to linuxdeepin/dtkcore that referenced this issue Dec 4, 2022
给gsettingsbackend添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
chenchongbiao added a commit to chenchongbiao/dtkwidget that referenced this issue Feb 3, 2023
更新danchors的文档

Log: update docs

Task: deepin-community/coding-quarter#26
deepin-bot bot pushed a commit to linuxdeepin/dtkwidget that referenced this issue Feb 3, 2023
更新danchors的文档

Log: update docs

Task: deepin-community/coding-quarter#26
Decodetalkers pushed a commit to Decodetalkers/dtkcore that referenced this issue Feb 7, 2023
给dsettings添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
Decodetalkers pushed a commit to Decodetalkers/dtkcore that referenced this issue Feb 7, 2023
给dsettingsgroup添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
Decodetalkers pushed a commit to Decodetalkers/dtkcore that referenced this issue Feb 7, 2023
给dsettingsoption添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
Decodetalkers pushed a commit to Decodetalkers/dtkcore that referenced this issue Feb 7, 2023
给dsettingsdconfigbackend添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
Decodetalkers pushed a commit to Decodetalkers/dtkcore that referenced this issue Feb 7, 2023
给gsettingsbackend添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
Decodetalkers pushed a commit to Decodetalkers/dtkcore that referenced this issue Feb 7, 2023
给qsettingbackend添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
Decodetalkers pushed a commit to Decodetalkers/dtkcore that referenced this issue Feb 7, 2023
给dconfigfile添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
Decodetalkers pushed a commit to Decodetalkers/dtkcore that referenced this issue Feb 7, 2023
给ddesktopentry添加文档注释

Log: add docs

Task: deepin-community/coding-quarter#26
Decodetalkers pushed a commit to Decodetalkers/dtkcore that referenced this issue Feb 7, 2023
给ddesktopentry添加例子

Log: add example

Task: deepin-community/coding-quarter#26
Decodetalkers pushed a commit to Decodetalkers/dtkcore that referenced this issue Feb 7, 2023
给dconfig添加例子

Log: add example

Task: deepin-community/coding-quarter#26
Decodetalkers pushed a commit to Decodetalkers/dtkcore that referenced this issue Feb 7, 2023
给dsysinfo添加例子

Log: add example

Task: deepin-community/coding-quarter#26
Decodetalkers pushed a commit to Decodetalkers/dtkcore that referenced this issue Feb 7, 2023
给dconfigfile添加例子

Log: add example

Task: deepin-community/coding-quarter#26
Decodetalkers pushed a commit to Decodetalkers/dtkcore that referenced this issue Feb 7, 2023
给dsettings添加例子

Log: add example

Task: deepin-community/coding-quarter#26
Decodetalkers pushed a commit to Decodetalkers/dtkcore that referenced this issue Feb 7, 2023
更新dfilesystemwatcher的文档

Log: update docs

Task: deepin-community/coding-quarter#26
@xzl01
Copy link
Contributor

xzl01 commented Mar 1, 2023

任务截止,完成规范化文档:11项 代码变更 :2699行 完成新增文档:8项 代码变更:1156行 特别加分项:输出教程文档

@xzl01 xzl01 added the 完成验收 已完成所有功能并通过验收 label Mar 1, 2023
@chenchongbiao chenchongbiao moved this from 已认领/进行中 to 完成验收 in 编程之季 任务进度看板 Mar 14, 2023
@chenchongbiao chenchongbiao moved this from 完成验收 to 已认领/进行中 in 编程之季 任务进度看板 Mar 14, 2023
@xzl01 xzl01 moved this from 已认领/进行中 to 完成验收 in 编程之季 任务进度看板 Mar 14, 2023
@xzl01
Copy link
Contributor

xzl01 commented Mar 14, 2023

评定:优秀

@xzl01
Copy link
Contributor

xzl01 commented Mar 22, 2023

评语:达到所期望的要求,在文档规范化过程中能很好的理解代码,并且在此基础上输出示例问答,评定为优秀

deepin-bot bot pushed a commit to linuxdeepin/dtkwidget that referenced this issue Jul 3, 2023
更新dpasswordedit的文档

Log: update docs

Task: deepin-community/coding-quarter#26
Whale107 pushed a commit to Whale107/dtkwidget that referenced this issue Aug 28, 2024
更新ddialog的文档

Log: update docs

Task: deepin-community/coding-quarter#26
Whale107 pushed a commit to Whale107/dtkwidget that referenced this issue Aug 28, 2024
更新danchors的文档

Log: update docs

Task: deepin-community/coding-quarter#26
Whale107 pushed a commit to Whale107/dtkwidget that referenced this issue Aug 28, 2024
更新dpasswordedit的文档

Log: update docs

Task: deepin-community/coding-quarter#26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
可重复认领 此任务可被重复认领 完成验收 已完成所有功能并通过验收 已确认认领 已由任务的联系人确认了任务的认领
Projects
Status: 完成验收
Development

No branches or pull requests

2 participants