From 41c0d9d6d270301169ccd44b7162dc30cd51dd34 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=9B=AA=E5=B1=B1=E5=87=8C=E7=8B=90?= <1277510+xueshanlinghu@user.noreply.gitee.com> Date: Fri, 6 Nov 2020 13:57:58 +0800 Subject: [PATCH] =?UTF-8?q?update=20=E7=AC=AC=E5=9B=9B=E9=83=A8=E5=88=86?= =?UTF-8?q?=E2=80=94=E2=80=94=E5=90=AF=E5=8A=A8=E8=87=AA=E5=B7=B1=E7=9A=84?= =?UTF-8?q?=E5=BC=80=E6=BA=90=E9=A1=B9=E7=9B=AE/=E4=B8=BA=E5=BC=80?= =?UTF-8?q?=E6=BA=90=E9=A1=B9=E7=9B=AE=E5=BB=BA=E7=AB=8B=E8=89=AF=E5=A5=BD?= =?UTF-8?q?=E7=9A=84=E5=9F=BA=E7=A1=80.md.=20=E5=86=85=E5=AE=B9=E8=A1=A5?= =?UTF-8?q?=E5=85=85=EF=BC=8C=E4=BF=AE=E6=AD=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...5\245\275\347\232\204\345\237\272\347\241\200.md" | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git "a/\347\254\254\345\233\233\351\203\250\345\210\206\342\200\224\342\200\224\345\220\257\345\212\250\350\207\252\345\267\261\347\232\204\345\274\200\346\272\220\351\241\271\347\233\256/\344\270\272\345\274\200\346\272\220\351\241\271\347\233\256\345\273\272\347\253\213\350\211\257\345\245\275\347\232\204\345\237\272\347\241\200.md" "b/\347\254\254\345\233\233\351\203\250\345\210\206\342\200\224\342\200\224\345\220\257\345\212\250\350\207\252\345\267\261\347\232\204\345\274\200\346\272\220\351\241\271\347\233\256/\344\270\272\345\274\200\346\272\220\351\241\271\347\233\256\345\273\272\347\253\213\350\211\257\345\245\275\347\232\204\345\237\272\347\241\200.md" index ad8e9f4..c985181 100644 --- "a/\347\254\254\345\233\233\351\203\250\345\210\206\342\200\224\342\200\224\345\220\257\345\212\250\350\207\252\345\267\261\347\232\204\345\274\200\346\272\220\351\241\271\347\233\256/\344\270\272\345\274\200\346\272\220\351\241\271\347\233\256\345\273\272\347\253\213\350\211\257\345\245\275\347\232\204\345\237\272\347\241\200.md" +++ "b/\347\254\254\345\233\233\351\203\250\345\210\206\342\200\224\342\200\224\345\220\257\345\212\250\350\207\252\345\267\261\347\232\204\345\274\200\346\272\220\351\241\271\347\233\256/\344\270\272\345\274\200\346\272\220\351\241\271\347\233\256\345\273\272\347\253\213\350\211\257\345\245\275\347\232\204\345\237\272\347\241\200.md" @@ -6,16 +6,16 @@ 如果是一种开源框架或者类库，可以用明确的功能来命名，如 ORM 类的框架，可以用 *SQL；如对象映射工具，则用 *Mapper；日志工具，则用 *Log…… -但是如果我们的项目是一款开源产品，就需要用既有辨识度又能让人易于记忆的名称了。那怎么能让人已于记忆呢？ +但是如果我们的项目是一款开源产品，就需要用既有辨识度又能让人易于记忆的名称了。那怎么能让人易于记忆呢？ -我个人的建议是反向利用联想记忆法，从项目的功能或者特点出发，联想到有一些关联又特别的名称。可以从影视作品、文学作品、游戏作品等取材，因为这些作品往往充满想象，拥有丰富的人物、事物设定。特别是从一些深受欢迎，传播深远的作品中获取灵感。 +我个人的建议是反向利用联想记忆法，从项目的功能或者特点出发，联想到有一些关联又特别的名称。可以从影视作品、文学作品、游戏作品等取材，因为这些作品往往充满想象，拥有丰富的人物、事物设定。特别是从一些深受欢迎，传播深远的作品中获取灵感。一个典型的案例是 `Python`，它的意思为`蟒蛇`，源于它的创始人龟叔（Guido van Rossum）很喜欢的英国 20 世纪 70 年代首播的电视喜剧《蒙提·派森的飞行马戏团》（Monty Python's Flying Circus）。 再缩小范围，就是技术群体喜欢的科幻、魔幻作品，比如星球大战、漫威、哈利波特、迪士尼等等。我尝试在下面列出一些已有的和我想到的例子： | 项目名称 | 项目类型 | 原意 | | ----------------- | --------------------| ----------------------| | Azkaban | 工作流 | 哈利波特中的一所监狱 | -| Tars | RPC 框架和配套平台 | 星际穿越"中的机器人 | +| Tars | RPC 框架和配套平台 | "星际穿越"中的机器人 | | ZooKeeper | 分布式服务注册和治理 | 动物园管理员 | | Elsa-workflow | 工作流 | 冰雪奇缘公主 | | Tomcat | Web 服务管理器 | 经典的汤姆猫 | @@ -29,7 +29,7 @@ ### 开源项目的代码质量要求 -一个认真打造的开源项目，肯定是希望有其他用户来使用，更希望有更多外部贡献者能参与进来。那么评价一个开源项目好不好，代码的质量就是非常重要的衡量指标了。 +一个认真打造的开源项目，肯定是希望有其他用户来使用，更希望有更多外部贡献者能参与进来的。那么评价一个开源项目好不好，代码的质量就是非常重要的衡量指标了。 代码质量是程序员的基本功，说到这个话题，首先自然是需要去翻阅经典的专著了，《重构》、《设计模式》、《代码整洁之道》是程序员必备的手边书。 @@ -41,7 +41,7 @@ 而一个开源项目的质量，除了代码本身以外，更重要的是整个项目的状态。 -首先最起码的是，这个项目必须编译通过。我们可以通过CI来把每次合并后的代码编译一遍，把编译状态通过 Badge 来展示。 +首先最起码的是，这个项目必须编译通过。我们可以通过 CI（Continuous integration 持续集成）来把每次合并后的代码编译一遍，把编译状态通过 Badge 来展示。 第二点，就是运行状况。是否能正常运行也是最基本的检查点了，有条件的话最好是通过 CI/CD 来把 Demo 站点运行起来。有一个可让用户即时尝试的 Demo，对开源项目的成功是非常有帮助的。 @@ -49,4 +49,4 @@ 第四点，就是外部贡献者数量。可能你会很奇怪，为什么我要把贡献者数量列进来？那是因为，他们对你这个项目的兴趣已经高到了会研究代码、并会贡献代码了，就能间接地说明这个项目的质量是有一定的分量的。他们愿意把它做得更好！ -第五点，生产案例。开源项目大多数是业余时间进行开发的，本身没有企业支持。那么，当它们被真正用于企业生产环境，并带来收益了，才说明这个项目是真正对用户有价值的。所以，开源项目可以收集一下用户的生产案例，一方面可以鼓励开源贡献者的付出、另一方面又可以展现这个项目的价值，还能对企业进行一定的宣传，这是三赢。 +第五点，生产案例。开源项目大多数是业余时间进行开发的，本身没有企业支持。那么，当它们被真正用于企业生产环境，并带来收益了，才说明这个项目是真正对用户有价值的。所以，开源项目可以收集一下用户的生产案例，一方面可以鼓励开源贡献者的付出，另一方面又可以展现这个项目的价值，还能对企业进行一定的宣传，这是三赢。 -- Gitee