[DTK] DTK文档需要与系统同步更新,让DTK开发者有更多时间关注其变化
Tofloor
poster avatar
deepin
2022-11-17 23:14
Author

关注deepin社区已经有3-4个多月,虽然系统的UI正在不断的进行更新,当然也包括驱动支持的更新。但是,我更希望DTK的开发文档也能进行同步更新,让DTK的演变能够趁早从QT中脱离出来,形成自己的软件开发生态。

由于自己是一名业余软件开发兴趣爱好者,我对deepin软件开发生态的基本认识,如下图:

image.png

这样的成长方式,实际上也让DTK初学者能对自己的开发水平有更好的认识,同时我们也要看到开发文档对于DTK初学者的重要意义,如果DTK相关的开发文档能够有更多的更新内容,则说明DTK会演变的越来越成熟,DTK的初学者也会在参考开发文档的过程中学习到更多有用的东西,并参与其他重要事项。

DTK开发文档的相关内容我在社区也曾建议过很多次,但是之后多次重新访问相关内容发现仍没有太多变化。以至于论坛有相关版主劝我先到github中建一个自己的SIG,但是中文社区的DTK文档不做好,我建立SIG的意义并不大。

因为Github公认的作用:给全球开源开发者提供优秀的源代码内容
image.png

如果我们直接让DTK初学者在github中提供设计、优质源码内容,这个对初学者来讲确实有点天方夜谭,也超出自己的能力范围和时间精力,只有把中文社区的DTK文档先完善、即时更新,才能培养更多github的DTK开源贡献者,已经和早期的Linux deepin发展战略🈶️很大不同。


最后,还是非常期待DTK开发文档的更新,如果官方没时间搞可以单独再搞一个文档群,反正UOS也在用DTK进行软件开发,我们定期去更新并发布DTK的开发文档,让编写代码优秀的开源爱好者也能更多加入到github的Linux deepin社区。

关于开发文档的编写,可参考

华为鸿蒙应用开发官网logo

,链接如下:Codelabs

Reply Favorite View the author
All Replies
心平气和
deepin
2022-11-18 00:52
#1

赞同。

Reply View the author
神末shenmo
deepin
Spark-App
Q&A Team
2022-11-18 04:40
#2

很赞同,友商的文档写的挺详细,而dtk的官方文档感觉像是机器生成的

只有那个案例像是人类写的。。。

我个人觉得倒不如放一个dtk example的地址


友商文档

https://gitee.com/openkylin/docs/blob/master/%E5%BC%80%E5%A7%8B%E8%B4%A1%E7%8C%AE/openKylin+SDK%E5%BC%80%E5%8F%91%E6%8C%87%E5%8D%97V2.0.md#4--%E5%BA%94%E7%94%A8%E6%94%AF%E6%92%91-sdk

Reply View the author
deepin
2022-11-18 18:54
#3
神末shenmo

很赞同,友商的文档写的挺详细,而dtk的官方文档感觉像是机器生成的

只有那个案例像是人类写的。。。

我个人觉得倒不如放一个dtk example的地址


友商文档

https://gitee.com/openkylin/docs/blob/master/%E5%BC%80%E5%A7%8B%E8%B4%A1%E7%8C%AE/openKylin+SDK%E5%BC%80%E5%8F%91%E6%8C%87%E5%8D%97V2.0.md#4--%E5%BA%94%E7%94%A8%E6%94%AF%E6%92%91-sdk

这个文档写的很详细。

Reply View the author
linxuan
deepin
2022-11-20 04:07
#4
It has been deleted!
linxuan
deepin
2022-11-20 04:08
#5

dtk小组一直很重视文档问题,现在dtk新模块全部以新标准去要求文档。目标是能让每一个开发者都会使用我们的dtk模块,目前正在推进传统dtk模块文档整理工作,也在筹划上线专属页面指导开发者。并且准备创立文档sig邀请社区共建。(文档采用doxygen进行管理,可以参见dtksystemsetting模块)

Reply View the author
BLumia
deepin
2022-11-21 17:58
#6

目前 DTK 的文档应该已经相比现有的线上文档详尽很多了,但出于文档平台架构局限性之类的原因,线上版本一直没有更新过。其实如果自己 doxygen 本地生成就会看到比现有线上版本充实的多的开发文档了。以及我们最近有计划提供 git master 版的文档自动生成和更新,不过本来是打算搞完了再告诉大家来着,随后准备好后会在我们的开发者邮件列表以及论坛一起公示一次applaud

关于组 DTK 文档 SIG 的事情,我觉得还是有比较大意义的,相当于有专门的小组来推进这件事,至少我的角度而言我很支持这么做。

p.s. 我们有面向 deepin 开发者的实时聊天群,有兴趣的话也可以加进来,地址可以在 Wiki 的这里找到~

Reply View the author