做项目不是喊口号,民族大义固然重要,但是也要走流程,没有规矩不成方圆。
首先,此次活动是华为一次运营营销活动,让大学生学习oh,注释目的是督促学生理解。此操作不在oh开发计划内。
第二,学生注释内容相当于学生笔记,基于学生对于某个仓库代码的理解而翻译,不应该合并到教材中。
第三,注释与代码分别储存,代码随时演进,注释无人维护。未来,注释版本跟不上代码版本,还是会被抛弃。
| |
杜天微
|
---- 回复的原邮件 ----
| 发件人 | Netroby via dev
开发者成长计划中的代码注释环节,意图是让学生去了解OH代码,尤其是那些无法下手写代码的去初步了解,设置的赛题数量和奖金都是偏低的,反馈社区的贡献不在计划目标范围内。 注释可以以独立的形式在社区去做和传播,交流。 注释是否能进主库听从PMC的专业指导意见,需保持社区代码的高质量。
朱其罡 手机:13701234598 OpenHarmony项目群工作委员会生态建设组
------------------ Original ------------------ From: "刘允礼 via dev"
; Date: Thu, Nov 25, 2021 04:48 PM To: "'962030'"<962030@qq.com>; Cc: "15390014138"<15390014138@163.com>; "dev" ; Subject: [Dev] Re: 申请开通cn_comment分支 钊哥,OHOS要开放就必然面临群体成员能力不一致的问题。加入中文注释不应该回避。我的建议是必须用英文注释,可以提供中文翻译作为辅助。
学生群体是潜在的巨大力量,不应排斥,应给予充分的成长空间。
代码会持续更新,不建议使用分支进行管理。
在 2021-11-25 15:58:51,"962030--- via dev"
写道: OHOS的编程规范有明确约束,要使用英文进行注释,因此强烈不建议在主库当中加入类似这样的中文注释内容。 另外,学生们的水平我们要有客观认识,他们的输出不足以直接合入主库。 李传钊
发件人: 15390014138--- via dev 发送时间: 2021-11-17 20:57 收件人: dev 主题: [Dev] 申请开通cn_comment分支 尊敬的PMC以及各成员:
目前openharmony开发者成长计划第二期题目中含有文档和代码注释类题目。 经过成长计划会议讨论,决定在主仓库内创建分支(分支名称暂定cn_comment, 即中文注释版本),方便未来参与者学习。
申请在openharmony主仓内部分代码仓库创建cn_comment (名称待定)分支,用于补充注释和文档 当前阶段影响的仓库有: https://gitee.com/openharmony/communication_ipc_lite
https://gitee.com/openharmony/communication_ipc
https://gitee.com/openharmony/communication_dsoftbus
https://gitee.com/openharmony/distributedschedule_samgr_lite
https://gitee.com/openharmony/distributedschedule_samgr
https://gitee.com/openharmony/distributedschedule_safwk_lite
https://gitee.com/openharmony/distributedschedule_safwk
https://gitee.com/openharmony/aafwk_aafwk_lite
https://gitee.com/openharmony/aafwk_standard
https://gitee.com/openharmony/appexecfwk_appexecfwk_lite
https://gitee.com/openharmony/appexecfwk_standard
冷钦街 _______________________________________________ dev mailing list -- dev@openharmony.io To unsubscribe send an email to dev-leave@openharmony.io
_______________________________________________ dev mailing list -- dev@openharmony.io To unsubscribe send an email to dev-leave@openharmony.io
_______________________________________________ dev mailing list -- dev@openharmony.io To unsubscribe send an email to dev-leave@openharmony.io