December 2021 - dev - lists.openatom.io

【会议纪要】OpenHarmony 架构SIG纪要20211109
by hengting (A) 08 Dec '21

08 Dec '21

【会议纪要】OpenHarmony 架构SIG纪要20211109 议题一：测试子系统申请新建开源仓third_party_benchmark—任翔结论： 1、同意在OpenHarmony新增third_party_benchmark开源仓。遗留问题： 1、Mini，Small benchmark库是否归一？会后闭环答复：benchmark库在标准与轻量级归一，均使用Google benchmark。 2、为什么使用Google benchmark？与OpenSSL Benchmark对比有什么优势？会后闭环答复：Google benchmark是专门针对C++ benchmark测试提供的测试库，提供了全面的性能测试接口，包括复杂度计算、多线程benchmark、模板化测试、CPU频率缩放等功能，简单易用。OpenSSL更擅长 IPv4、Ipv6协议及网络为主的场景下进行性能测试，因此选型时选用Google benchmark，更符合TDD C++ benchmark测试场景。议题二：帐号子系统申请新建开源仓account_app_account—徐大庆结论： 1、同意在OpenHarmony下新增帐号子系统开源仓account_app_account。遗留问题： 1、应用帐号在标准系统和大型系统上部件名不同，如何考虑代码服用？会后闭环答复：目前无代码可复用，后续涉及到复用时，以开源项目整体策略为准，统一处理。 2、支持按需跨设备同步的特性如何保证数据同步的时效性？会后闭环答复：目前设计与大型系统一致，依赖分布式数据管理的自动同步机制，后续会考虑自动+手动同步的机制，提高时效性。 From: hengting (A) Sent: Monday, November 8, 2021 4:27 PM To: Rengelin <rengelin(a)huawei.com>; wanchengzhen <wanchengzhen(a)huawei.com>; Zhangyongzhi <zhangyongzhi(a)huawei.com>; Qiangbo(Paul,OpenHarmony) <qiangbo2(a)huawei.com>; dongjinguang <dongjinguang(a)huawei.com>; renxiang (E) <renxiang11(a)huawei.com>; Xudaqing <xudaqing(a)huawei.com> Cc: 'dev(a)openharmony.io' <dev(a)openharmony.io> Subject: 【会议通知】OpenHarmony 架构SIG，时间：2021-11-09 09:30-10:30，地点：线上会议，请您准时与会：）会议主题 Subject OpenHarmony 架构SIG 会议时间 Time 2021-11-09 09:30-10:30(UTC+08:00)Beijing 会议地点 Location 线上会议召集人 Convener 董金光视频会议 Video Meeting 加入会议： Join (Host) <http://imeeting.huawei.com/meeting/startzoom?id=a6288118882a4a65a66d1b94231…> Join (Internal) <http://imeeting.huawei.com/meeting/joinzoom?id=0180249460&app=welink> Join (External) <https://welink.zhumu.com/j/180249460> 地点：线上会议会议ID： 0180249460 与会人 Attendees 万承臻；任革林；张勇智；强波；董金光外部与会人 External Participants dev(a)openharmony.io<mailto:dev@openharmony.io> 会议议题 Agenda 编号 No. 议题名称 Topic 议题背景介绍 Topic background introduction 时长 Duration 提案人 Proposer 汇报人 Reporter 纪要人 Recorder 议题参与人 Members 1 测试子系统申请新建开源仓third_party_benchmark 测试子系统C++ benchmark测试11月底开源 10 任翔任翔任翔任翔 2 帐号子系统申请新建开源仓account_app_account 帐号子系统业务包括系统帐号和应用帐号，分别对应部件account_os_account和account_app_account。社区上开源的仅有系统帐号的分布式组网帐号状态管理，本地多用户生命周期和应用帐号的功能不具备。OpenHarmony 3.1交付的基础功能需要新增支持本地多用户生命周期和应用帐号，其中应用帐号需要单独建仓，且11月有技术合作项目交付的内容涉及该仓。 10 徐大庆徐大庆徐大庆徐大庆

1 0

OpenHarmoy PMC Biweekly Meeting Time:2021-12-9 09:30-10:30
by hengting (A) 07 Dec '21

07 Dec '21

会议主题 Subject OpenHarmoy PMC Biweekly Meeting 会议时间 Time 2021-12-9 09:30-10:30(UTC+08:00)Beijing 会议地点 Location 线上会议召集人 Convener 董金光视频会议 Video Meeting 加入会议： Join (Host) <http://imeeting.huawei.com/meeting/startzoom?id=d944ff1e7d00426a819475b2b27…> Join (Internal) <http://imeeting.huawei.com/meeting/joinzoom?id=0172710381&app=welink> Join (External) <https://welink.zhumu.com/j/172710381> 地点：线上会议与会人 Attendees 李毅；高泉；董金光；万承臻；任革林；付天福；吴勇辉；王意明；邢文华；强波；鲜余强；余枝强；李家欣；马耀辉；赵文华；丁勇；高涵一外部与会人 External Participants 梁克雷；黄明龙会议议题 Agenda 编号 No. 议题名称 Topic 议题背景介绍 Topic background introduction 时长 Duration 提案人 Proposer 汇报人 Reporter 纪要人 Recorder 议题参与人 Members 1 OH辅助工具SIG 负责openharmony开发效率提升的一些工具 15min 张亮亮张亮亮张亮亮陈迅、巴延兴、李祥志、张亮亮 2 新成员提名提议刘洋加入PMC，看护代码架构 15min 刘洋刘洋刘洋刘洋、董金光、梁克雷、黄明龙 3 OpenHarmony项目社区运营目标、计划对齐2022年社区运营目标 15min 张明修张明修张明修 PMC成员 4 OpenHarmony社区代码共建目标及思路对齐社区代码共建目标及思路 15min 林志南林志南林志南鲁波、董金光、各sig leader 会议公告上次会议纪要：https://gitee.com/openharmony/community/blob/master/meeting-notes/20…

1 0

OpenHarmony基础软件SIG例会
by Zhangxiaotian (Handy) 07 Dec '21

07 Dec '21

OpenHarmony基础软件SIG例会序号议题 1 OpenHarmony社区L2 qemu模拟器现状分享 -- wawanala<https://gitee.com/wawanala> 2 OpenHarmony命令行进程级调试变量传入通道方案讨论 -- all 3 深开鸿OTA能力建设讨论会议时间： 12月8日（周三）14:15-16:15 会议地点：电话会议会议主题： OpenHarmony基础软件SIG例会召集人：张小田与会人：软件所：梁克雷，黄明龙，罗未，谭小凡，李凯，Chandwich KOL：李传钊润和：刘洋社区：wawanala<https://gitee.com/wawanala> 华为：董金光，任革林，万承臻，张小田，白永刚，李加润，李煜，刘威，唐城开，徐大庆，张政学，王兴，熊小勇，易见，李开龙，马耀辉，袁博会议接入： * 时间 : 2021-12-08 14:15-16:15 ((UTC+08:00)Beijing) * 加入会议 : * Join (Internal) >><http://imeeting.huawei.com/meeting/joinzoom?id=0152869740&app=welink> * Join (External) >><https://welink.zhumu.com/j/152869740> * 会议ID : 0152869740 (会议ID在本次会议结束后不可继续使用)

1 0

SIG-Charter-Proposal-T_HEAD
by 519689417＠qq.com 03 Dec '21

03 Dec '21

背景信息：鸿蒙融合需求，需要新增平头哥开发板业务范围：平头哥相关开发板适配业务目标：适配完成平头哥相关平台开发板，支持csky指令集。

2 3

Re: �ظ�: Re: Re: ��뿪ͨcn_comment��֧
by 泛舟西湖 02 Dec '21

02 Dec '21

狭隘民族主义要不得，光喊口号没用，科技尽量远离政治看过计算机架构组织原理，应该知道怎么做不懂就学，比较花两个字节存储一个汉字以及各种乱七八糟编码变换，都是巨型内卷 ---Original--- From: "962030--- via dev"<dev(a)openharmony.io> Date: Fri, Nov 26, 2021 16:07 PM To: "15390014138"<15390014138(a)163.com>;"Netroby"<hufeng1987(a)gmail.com>; Cc: "朱其罡"<qigang(a)openatom.org>;"刘允礼"<ylliu3788(a)163.com>;"dev"<dev(a)openharmony.io>; Subject: [Dev] �ظ�: Re: Re: ��뿪ͨcn_comment��֧ 就是要振兴中华才要用英文写注释，操作系统作为IT基础设施，光在窝里横是没前途的，基金会现在已经跟eclipse基金会合作开启了名为Oniro的欧洲发行版。不仅要用英文写注释，还要写好，写的精准，这是能耐，这不是什么崇洋媚外。不仅要写好英文注释，还要写好英文文档，还要写好英文log信息，还要规范代码里不好的变量命名。李传钊   发件人： 15390014138 发送时间： 2021-11-26 12:38 收件人： Netroby 抄送： 朱其罡; 刘允礼; 962030; dev 主题： Re:Re: [Dev] Re: 申请开通cn_comment分支基于代码注释这个任务，主要作用是2点： 1. 参与本项目的学生接触OH代码，学习知识并沉淀。这个放普通的仓库即可。 2. 未来需要加入OH的学生，需要一个方便的查看含注释代码的渠道，如果是在主仓中的话，更方便，省去了推广，否则还需要推广成本，告诉学生哪里有含中文注释的代码可以看。如果推广这个难度不用担忧的话，我个人觉得确实没有必要放主仓。在 2021-11-26 11:22:19，"Netroby" <hufeng1987(a)gmail.com> 写道： >大佬们好。 >我绝对支持中文注释， >原因是：英文是大英帝国殖民遗留的历史问题。大英帝国旗帜插在哪里，英语就在哪里。 > > >而中文，自古以来就是中国官方行文官方语言。 > >中文至少得到支持，不应该被放弃。 > >我们中国的开源项目，为什么不用中文？为什么要用英文作为主语言。 > >我100支持中文。 > >英文可以学，可以支持，但不应该为英文放弃中文。 > >自强不息，从我辈做起，如果我们自甘泯灭自己的文化和传统。不学中文，不用好中文。 > >都不用美帝国主义制裁，我们自己就不行了。 > > >Appreciate your time. >---------------------------- >Netroby > >朱其罡 via dev <dev(a)openharmony.io> 于2021年11月26日周五上午11:09写道： >> >> 开发者成长计划中的代码注释环节，意图是让学生去了解OH代码，尤其是那些无法下手写代码的去初步了解，设置的赛题数量和奖金都是偏低的，反馈社区的贡献不在计划目标范围内。 >> 注释可以以独立的形式在社区去做和传播，交流。 >> 注释是否能进主库听从PMC的专业指导意见，需保持社区代码的高质量。 >> >> 朱其罡 >> 手机：13701234598 >> OpenHarmony项目群工作委员会生态建设组 >> >> >> >> ------------------ Original ------------------ >> From: "刘允礼 via dev"<dev(a)openharmony.io>; >> Date: Thu, Nov 25, 2021 04:48 PM >> To: "'962030'"<962030(a)qq.com>; >> Cc: "15390014138"<15390014138(a)163.com>; "dev"<dev(a)openharmony.io>; >> Subject: [Dev] Re: 申请开通cn_comment分支 >> >> >> 钊哥，OHOS要开放就必然面临群体成员能力不一致的问题。加入中文注释不应该回避。我的建议是必须用英文注释，可以提供中文翻译作为辅助。 >> >> 学生群体是潜在的巨大力量，不应排斥，应给予充分的成长空间。 >> >> >> 代码会持续更新，不建议使用分支进行管理。 >> >> >> 在 2021-11-25 15:58:51，"962030--- via dev" <dev(a)openharmony.io> 写道： >> >> 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(a)openharmony.io >> To unsubscribe send an email to dev-leave(a)openharmony.io >> >> >> >> >> >> _______________________________________________ >> dev mailing list -- dev(a)openharmony.io >> To unsubscribe send an email to dev-leave(a)openharmony.io  

5 4

回复：回复:回复：关于代码中使用中文注释的问题
by 李传钊 02 Dec '21

02 Dec '21

要加强学习，提高讨论的质量，不要随意占用大家的时间。 ---原始邮件--- 发件人: "杜天微 via dev"<dev(a)openharmony.io> 发送时间: 2021年12月1日(周三) 下午5:31 收件人: "开源鸿蒙开发组"<dev(a)openharmony.io>; 主题: [Dev] 回复:回复：关于代码中使用中文注释的问题国际化。不是注释，是指南、手册。 OH，也有这个东西。 https://gitee.com/openharmony/docs/tree/master/en 在 2021-12-01 16:43:45，"刘允礼 via dev" <dev(a)openharmony.io> 写道：我倒是很想听听你们对这个路径下文件的意见 https://github.com/torvalds/linux/tree/master/Documentation/translations/zh… ylliu3788 ylliu3788(a)163.com 签名由网易邮箱大师定制在2021年11月30日 23:26，Luo Xiaogang via dev<dev(a)openharmony.io> 写道：我坚决反对在代码中加入中文注释。在代码中加入中文注释，有没有考虑过写代码的人的感受？有没有考虑过看代码的人的感受？还是说这些要求在代码中加入中文注释的人从来不写代码，也不看代码？前面回复的几封邮件，主题已经是乱码了，让使用者如何理解？ 1、中文注释，会让开发者在中英文输入状态下反复切换，体验极差，还有一些语法问题。 2、中文注释，对于阅读者，不同的编码方式，会导致乱码。如果10个文件，有多种文件编码方式，怎么看？？有 utf-8，gb2312, gb18030 等等。 3、是不是 commit message 也要中文注释？如果这样，git log 就非常难用了。 4、如果系统是纯英文的，怎么写中文注释？我们需要有一个开放的心态，需要国际视野，不能仅仅局限于国内。关于如何写注释，如果不会，可以去学习宋宝华老师的视频课程：《编写高质量注释之道》代码应该是自注释的，应该是很容易理解的，而不是晦涩难懂的。如果是晦涩难懂的代码，说明代码的质量有问题，需要改进。注释更多的是描述代码背后的故事，而不是代码本身。建议大家多研究一下 linux 的代码，包含代码风格、代码质量、架构、注释等。在 2021-11-28 21:05:38，"泛舟西湖 via dev" <dev(a)openharmony.io> 写道：狭隘民族主义要不得，光喊口号没用，科技尽量远离政治看过计算机架构组织原理，应该知道怎么做不懂就学，比较花两个字节存储一个汉字以及各种乱七八糟编码变换，都是巨型内卷 ---Original--- From: "962030--- via dev"<dev(a)openharmony.io> Date: Fri, Nov 26, 2021 16:07 PM To: "15390014138"<15390014138(a)163.com>;"Netroby"<hufeng1987(a)gmail.com>; Cc: "朱其罡"<qigang(a)openatom.org>;"刘允礼"<ylliu3788(a)163.com>;"dev"<dev(a)openharmony.io>; Subject: [Dev] ظ : Re: Re: 뿪ͨcn_comment ֧ 就是要振兴中华才要用英文写注释，操作系统作为IT基础设施，光在窝里横是没前途的，基金会现在已经跟eclipse基金会合作开启了名为Oniro的欧洲发行版。不仅要用英文写注释，还要写好，写的精准，这是能耐，这不是什么崇洋媚外。不仅要写好英文注释，还要写好英文文档，还要写好英文log信息，还要规范代码里不好的变量命名。李传钊   发件人： 15390014138 发送时间： 2021-11-26 12:38 收件人： Netroby 抄送： 朱其罡; 刘允礼; 962030; dev 主题： Re:Re: [Dev] Re: 申请开通cn_comment分支基于代码注释这个任务，主要作用是2点： 1. 参与本项目的学生接触OH代码，学习知识并沉淀。这个放普通的仓库即可。 2. 未来需要加入OH的学生，需要一个方便的查看含注释代码的渠道，如果是在主仓中的话，更方便，省去了推广，否则还需要推广成本，告诉学生哪里有含中文注释的代码可以看。如果推广这个难度不用担忧的话，我个人觉得确实没有必要放主仓。在 2021-11-26 11:22:19，"Netroby" <hufeng1987(a)gmail.com> 写道： >大佬们好。 >我绝对支持中文注释， >原因是：英文是大英帝国殖民遗留的历史问题。大英帝国旗帜插在哪里，英语就在哪里。 > > >而中文，自古以来就是中国官方行文官方语言。 > >中文至少得到支持，不应该被放弃。 > >我们中国的开源项目，为什么不用中文？为什么要用英文作为主语言。 > >我100支持中文。 > >英文可以学，可以支持，但不应该为英文放弃中文。 > >自强不息，从我辈做起，如果我们自甘泯灭自己的文化和传统。不学中文，不用好中文。 > >都不用美帝国主义制裁，我们自己就不行了。 > > >Appreciate your time. >---------------------------- >Netroby > >朱其罡 via dev <dev(a)openharmony.io> 于2021年11月26日周五上午11:09写道： >> >> 开发者成长计划中的代码注释环节，意图是让学生去了解OH代码，尤其是那些无法下手写代码的去初步了解，设置的赛题数量和奖金都是偏低的，反馈社区的贡献不在计划目标范围内。 >> 注释可以以独立的形式在社区去做和传播，交流。 >> 注释是否能进主库听从PMC的专业指导意见，需保持社区代码的高质量。 >> >> 朱其罡 >> 手机：13701234598 >> OpenHarmony项目群工作委员会生态建设组 >> >> >> >> ------------------ Original ------------------ >> From: "刘允礼 via dev"<dev(a)openharmony.io>; >> Date: Thu, Nov 25, 2021 04:48 PM >> To: "'962030'"<962030(a)qq.com>; >> Cc: "15390014138"<15390014138(a)163.com>; "dev"<dev(a)openharmony.io>; >> Subject: [Dev] Re: 申请开通cn_comment分支 >> >> >> 钊哥，OHOS要开放就必然面临群体成员能力不一致的问题。加入中文注释不应该回避。我的建议是必须用英文注释，可以提供中文翻译作为辅助。 >> >> 学生群体是潜在的巨大力量，不应排斥，应给予充分的成长空间。 >> >> >> 代码会持续更新，不建议使用分支进行管理。 >> >> >> 在 2021-11-25 15:58:51，"962030--- via dev" <dev(a)openharmony.io> 写道： >> >> 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(a)openharmony.io >> To unsubscribe send an email to dev-leave(a)openharmony.io >> >> >> >> >> >> _______________________________________________ >> dev mailing list -- dev(a)openharmony.io >> To unsubscribe send an email to dev-leave(a)openharmony.io      

3 2

Re: 回复: Re: Re: 申请开通cn_comment分支
by Jerry 01 Dec '21

01 Dec '21

各位优秀的前辈们的讨论都很精彩，我从参加这个代码注释计划的成员角度谈一下我的看法，限于个人水平，其中有不正确的地方还望各位前辈指正：从我接触OpenHarmony(下称ohos)的经历出发，我认为ohos目前的文档、指南、示例很差，对于刚刚接触ohos来说很不友好，对于那些只会调库或者刚刚接触这一块的人来说无从下手。而文档的友好程度和资源的丰富程度恰恰是很多初学者入门时最看重的点，这是linux做的非常优秀的点，也是ohos做的非常差的点。代码注释计划可以在一定程度上解决这个问题。具有丰富专业知识的社区核心人员没有精力去做这个事情，而想为社区做点事情的但能力达不到贡献核心代码的人（比如我）乐意去做这样的事情，社区应该为这批人提供一个机会和指导，教会了这批人后这批人可以去辐射到更多的人。而目前做这个事情来看，最合适的语言应该是中文。因为就ohos目前情况来看，最可能发展壮大的的地方还是中国大陆，而中国大陆的能够参与到这个项目来的应该都会中文，后续为了国际化全球化，可以像python的文档一样，由中文版本逐渐衍生出英文版本。我个人认为这次注释计划的成果不适合合并到主干分支的代码中，在这一点上我赞同Luo Xiaogang 的观点。主干分支代码中不应该有任何的中文。但我认为示例程序、文档、教程等，应该以中文版本为主，以方便在国内推广。中文注释的代码可以作为教程或者文档的一个组成部分，由一个fork出的仓库或者分支的形式呈现。主干代码的文档中应该有明显的位置帮助人们快速找到这些内容。至于Netroby 的观点，我不能赞同。这里我引用习近平同志的一段话作为我反对的理论依据：“传承中华文化，绝不是简单复古，也不是盲目排外，而是古为今用、洋为中用，辩证取舍、推陈出新，摒弃消极因素，继承积极思想，“以古人之规矩，开自己之生面”，实现中华文化的创造性转化和创新性发展。”全文可以参考习近平同志在《求是》杂志上发表的署名文章，《坚定文化自信，建设社会主义文化强国》。李传钊前辈的观点“ 另外，学生们的水平我们要有客观认识，他们的输出不足以直接合入主库。”我也难以苟同。我认为评判输出能否合并入主库的应该是其代码对ohos的贡献，而不是他们的身份。我身边有同学已经是Rust社区的贡献者，每个使用Rust的人都不可能绕过他的贡献，而且很多同学就业后进入的是国内外的大厂，他们的代码也已经进入到了各大软件中，我不认为他们的代码水平不能满足ohos社区的要求。此外，主库中也有一些边边角角东西是核心开发者没有时间去维护的，比如文档、示例程序等等，这部分核心开发者不愿意做的工作，如果愿意做的低水平开发者你们又看不起，那就只能使ohos变成少数人的os。比如dsoftbus仓库中文档中的简单的函数参数错误，至今都没修复。最后，祝ohos能真正担负起时代赋予它的使命。

1 0

回复：关于代码中使用中文注释的问题
by 泛舟西湖 01 Dec '21

01 Dec '21

这个是一个国际化标准问题，目前为止成员参差不齐，还没到那程度有些事情需要到一定阶段去做才有意义 Linux 国际化标准组织 li18nux www.li18nux.org ---原始邮件--- 发件人: "刘允礼"<ylliu3788(a)163.com> 发送时间: 2021年12月1日(周三) 下午4:43 收件人: "lxgrxd(a)163.com"<lxgrxd(a)163.com>; 抄送: "23273143(a)qq.com"<23273143(a)qq.com>;"962030(a)qq.com"<962030(a)qq.com>;"15390014138"<15390014138(a)163.com>;"hufeng1987(a)gmail.com"<hufeng1987(a)gmail.com>;"qigang(a)openatom.org"<qigang(a)openatom.org>;"dev"<dev(a)openharmony.io>; 主题: 回复：[Dev] 关于代码中使用中文注释的问题我倒是很想听听你们对这个路径下文件的意见 https://github.com/torvalds/linux/tree/master/Documentation/translations/zh… ylliu3788 ylliu3788(a)163.com 签名由网易邮箱大师定制在2021年11月30日 23:26，Luo Xiaogang via dev<dev(a)openharmony.io> 写道：我坚决反对在代码中加入中文注释。在代码中加入中文注释，有没有考虑过写代码的人的感受？有没有考虑过看代码的人的感受？还是说这些要求在代码中加入中文注释的人从来不写代码，也不看代码？前面回复的几封邮件，主题已经是乱码了，让使用者如何理解？ 1、中文注释，会让开发者在中英文输入状态下反复切换，体验极差，还有一些语法问题。 2、中文注释，对于阅读者，不同的编码方式，会导致乱码。如果10个文件，有多种文件编码方式，怎么看？？有 utf-8，gb2312, gb18030 等等。 3、是不是 commit message 也要中文注释？如果这样，git log 就非常难用了。 4、如果系统是纯英文的，怎么写中文注释？我们需要有一个开放的心态，需要国际视野，不能仅仅局限于国内。关于如何写注释，如果不会，可以去学习宋宝华老师的视频课程：《编写高质量注释之道》代码应该是自注释的，应该是很容易理解的，而不是晦涩难懂的。如果是晦涩难懂的代码，说明代码的质量有问题，需要改进。注释更多的是描述代码背后的故事，而不是代码本身。建议大家多研究一下 linux 的代码，包含代码风格、代码质量、架构、注释等。在 2021-11-28 21:05:38，"泛舟西湖 via dev" <dev(a)openharmony.io> 写道：狭隘民族主义要不得，光喊口号没用，科技尽量远离政治看过计算机架构组织原理，应该知道怎么做不懂就学，比较花两个字节存储一个汉字以及各种乱七八糟编码变换，都是巨型内卷 ---Original--- From: "962030--- via dev"<dev(a)openharmony.io> Date: Fri, Nov 26, 2021 16:07 PM To: "15390014138"<15390014138(a)163.com>;"Netroby"<hufeng1987(a)gmail.com>; Cc: "朱其罡"<qigang(a)openatom.org>;"刘允礼"<ylliu3788(a)163.com>;"dev"<dev(a)openharmony.io>; Subject: [Dev] ظ : Re: Re: 뿪ͨcn_comment ֧ 就是要振兴中华才要用英文写注释，操作系统作为IT基础设施，光在窝里横是没前途的，基金会现在已经跟eclipse基金会合作开启了名为Oniro的欧洲发行版。不仅要用英文写注释，还要写好，写的精准，这是能耐，这不是什么崇洋媚外。不仅要写好英文注释，还要写好英文文档，还要写好英文log信息，还要规范代码里不好的变量命名。李传钊   发件人： 15390014138 发送时间： 2021-11-26 12:38 收件人： Netroby 抄送： 朱其罡; 刘允礼; 962030; dev 主题： Re:Re: [Dev] Re: 申请开通cn_comment分支基于代码注释这个任务，主要作用是2点： 1. 参与本项目的学生接触OH代码，学习知识并沉淀。这个放普通的仓库即可。 2. 未来需要加入OH的学生，需要一个方便的查看含注释代码的渠道，如果是在主仓中的话，更方便，省去了推广，否则还需要推广成本，告诉学生哪里有含中文注释的代码可以看。如果推广这个难度不用担忧的话，我个人觉得确实没有必要放主仓。在 2021-11-26 11:22:19，"Netroby" <hufeng1987(a)gmail.com> 写道： >大佬们好。 >我绝对支持中文注释， >原因是：英文是大英帝国殖民遗留的历史问题。大英帝国旗帜插在哪里，英语就在哪里。 > > >而中文，自古以来就是中国官方行文官方语言。 > >中文至少得到支持，不应该被放弃。 > >我们中国的开源项目，为什么不用中文？为什么要用英文作为主语言。 > >我100支持中文。 > >英文可以学，可以支持，但不应该为英文放弃中文。 > >自强不息，从我辈做起，如果我们自甘泯灭自己的文化和传统。不学中文，不用好中文。 > >都不用美帝国主义制裁，我们自己就不行了。 > > >Appreciate your time. >---------------------------- >Netroby > >朱其罡 via dev <dev(a)openharmony.io> 于2021年11月26日周五上午11:09写道： >> >> 开发者成长计划中的代码注释环节，意图是让学生去了解OH代码，尤其是那些无法下手写代码的去初步了解，设置的赛题数量和奖金都是偏低的，反馈社区的贡献不在计划目标范围内。 >> 注释可以以独立的形式在社区去做和传播，交流。 >> 注释是否能进主库听从PMC的专业指导意见，需保持社区代码的高质量。 >> >> 朱其罡 >> 手机：13701234598 >> OpenHarmony项目群工作委员会生态建设组 >> >> >> >> ------------------ Original ------------------ >> From: "刘允礼 via dev"<dev(a)openharmony.io>; >> Date: Thu, Nov 25, 2021 04:48 PM >> To: "'962030'"<962030(a)qq.com>; >> Cc: "15390014138"<15390014138(a)163.com>; "dev"<dev(a)openharmony.io>; >> Subject: [Dev] Re: 申请开通cn_comment分支 >> >> >> 钊哥，OHOS要开放就必然面临群体成员能力不一致的问题。加入中文注释不应该回避。我的建议是必须用英文注释，可以提供中文翻译作为辅助。 >> >> 学生群体是潜在的巨大力量，不应排斥，应给予充分的成长空间。 >> >> >> 代码会持续更新，不建议使用分支进行管理。 >> >> >> 在 2021-11-25 15:58:51，"962030--- via dev" <dev(a)openharmony.io> 写道： >> >> 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(a)openharmony.io >> To unsubscribe send an email to dev-leave(a)openharmony.io >> >> >> >> >> >> _______________________________________________ >> dev mailing list -- dev(a)openharmony.io >> To unsubscribe send an email to dev-leave(a)openharmony.io    

1 0