开发者成长计划中的代码注释环节,意图是让学生去了解OH代码,尤其是那些无法下手写代码的去初步了解,设置的赛题数量和奖金都是偏低的,反馈社区的贡献不在计划目标范围内。
注释可以以独立的形式在社区去做和传播,交流。
注释是否能进主库听从PMC的专业指导意见,需保持社区代码的高质量。
 
朱其罡
手机:13701234598
OpenHarmony项目群工作委员会生态建设组
 
 
 
------------------ Original ------------------
Date:  Thu, Nov 25, 2021 04:48 PM
To:  "'962030'"<962030@qq.com>;
Cc:  "15390014138"<15390014138@163.com>; "dev"<dev@openharmony.io>;
Subject:   [Dev] Re: 申请开通cn_comment分支
 

钊哥,OHOS要开放就必然面临群体成员能力不一致的问题。加入中文注释不应该回避。我的建议是必须用英文注释,可以提供中文翻译作为辅助。

学生群体是潜在的巨大力量,不应排斥,应给予充分的成长空间。


代码会持续更新,不建议使用分支进行管理。


在 2021-11-25 15:58:51,"962030--- via dev" <dev@openharmony.io> 写道:

OHOS的编程规范有明确约束,要使用英文进行注释,因此强烈不建议在主库当中加入类似这样的中文注释内容。
另外,学生们的水平我们要有客观认识,他们的输出不足以直接合入主库。
李传钊
发送时间: 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