如何成为一个参加过Selenium开发的成员

相信大家都有使用Selenium的经验,每每看到各种大神参与过各种开源项目而羡慕不已,其实重要的并不完全是能力而是你是否有参与的态度,参考某个孩子给Linux核心提交过代码。

4岁小女孩给Linux内核贡献提交,修改一个字符网友狂点赞!

那么作为大家在使用Selenium的朋友,如果想为Selenium做点自己的贡献呢?下面云层分享一下可以做的一个简单而有意义的工作,文档本地化!

项目地址及生产结果

SeleniumHQ的Github地址:

官网文档同步更新(左下角选中文模式)

https://www.selenium.dev/documentation/zh-cn/worst_practices/two_factor_authentication/

如何找到要翻译的页面

打开Selenium的文档官网,请先整体阅读一下所有章节,会发现有很多地方比我们常用的写法更加优秀和规范的代码案例,非常值得学习,接着切换左下角的语言到中文简体(如果发现中文不顺口也可以提交修正的)。

这个时候可以发现内容基本都变成中文了,其实仔细查找还是能发现一些没有完全翻译的章节,例如

如果我们想参与这个章节的翻译就可以点击右上角的Edit this page了,当然结果是404,因为我们没有权限在Master分支上进行修改,当然得先改开发分支Merge主干。

查找对应文档的开发分支

首先切换回Github的基本项目路径

https://github.com/SeleniumHQ/seleniumhq.github.io

注意红色选中的docs_source_files就是我们的可以修改的分支,当然github账户先准备好吧!!!!!

接着按照文档默认的分类目录找到对应的中文文件.zh-cn.md后缀文件!

成为修改开发分支的那个人

点开要修改的文件,点击右侧的修改按钮,强烈推荐修改完了自己保存一份(基于MarkDown格式)

翻译的过程不用多说了吧,养成同时开3个翻译工具(Google、Bing、有道/百度)的习惯,并且评估信雅达的翻译追求,让中文发挥其有韵味的特点。

例如:

Selenium 4 alpha versions have much awaited native support for Chrome Dev Protocol through "DevTools" interface. This helps us getting Chrome Development properties such as Application Cache, Fetch, Network, Performance, Profiler, Resource Timing, Security and Target CDP domains etc.

云层的翻译可能是

在Selenium 4 alpha版本通过对Chrome开发协议(Chrome Dev Protocol)的支持添加了大家期待已久的源生Chrome开发工具“DevTools”调用。这将帮助我们获取Chrome开发属性集例如:应用程序缓存、获取、网络、性能、探查器、资源计时、安全性和目标CDP域等。

这段翻译有几个很麻烦的地方,Chrome开发工具官方对于菜单的翻译是什么?其次关于Target CDP domains的翻译,在查看了相关官方文档后,可以发现这块是Chrome开发工具中提供的网络操作的功能,官方文档

https://chromedevtools.github.io/devtools-protocol/tot/Fetch/

如果只是简单的翻译作为中文读者来说是很难理解的,这个时候我也发现了英文原文可能存在的一点问题,Chrome Dev Protocol 这个协议在官方是称之为Chrome DevTools Protocol的,所以就陷入了难处。

这块的翻译云层还没翻译达到自己觉得比较好的状态,完成所以也没有提交,大家可以自己琢磨一下。修改完成可以点击提交,这个提交不会有问题因为并不会对内容产生实质影响,但是既然是提交还是尽量深思熟虑。

如果提交不知道写啥就写Localization吧,因为本来就是.zh-cn老外自然知道你做了本地化:)

提交变更后会出现一个新的patch分支,对于上次没修改好的内容可以继续修改,直道达标再申请合并主干。

再次修改文件提交会询问是否提交到自己patch分支

申请合并主干

写完了觉得的好?那么就申请主干吧!但是请。。。真的好好看看自己写的东西是不是合格:)写的不好通过了也蛮丢人的是不?

提交成功后会看到这样的合并说明,如果点击Create pull request,那么就会真的开始合并发布过程,由于当下我不需要走真正的发布流程,所以这里就不点了。

讨论发布及协议确认

由于上一次我提交的过程记得不是非常清楚,所以这里根据提交的历史做一下回顾:

https://github.com/SeleniumHQ/seleniumhq.github.io/pull/463

首先需要在提交的时候更新提交表单

注意说明修改的内容及原因。

主要填写这次提交的内容描述及文本,修改类型(我是全文翻译所以选第四个新翻译),贡献文档(看一下规范,其实我后面犯了个错),我没通过hugo去确认文档格式规范性,因为没涉及到代码,看不懂可以直接谷歌浏览器在线翻译!

提交之后一般1天内会有人参与这个提交的讨论所以注意下自己的Pull历史,大家可以在我的提交历史中发现几个问题:

  1. 没有签署CLA

这里面一直确定就行了,主要是同一对本地化贡献的协议认可!提交完成可以使用acked回复,来确认已经满足。

2.忘了删除翻译默认的提示信息。

在默认文档的开头有这么一句

{{% notice info %}} Page being translated from English to Chinese. Do you speak Chinese? Help us to translate it by sending us pull requests! {{% /notice %}}

既然翻译完了就可以删除了,这句话是对应标准文档的这段

收工

如果一切顺利,在经历几天后,你就可以看到自己的提交合并成功,恭喜你在官网上的文档也同步更新了。也许在技术上并没有所谓的高精尖,但是这一切不就是一个好的开始么!好歹简历上可以写,我也是参加过Selenium项目的男人了,虽然只是本地化!

以上内容如果能对你的工作和学习有一丁点帮助的话,跪求移步B站给云层一波三连。

扫码即看B站视频版

TestOps公众号

微信号 :TestOps

新浪微博:@TestOps官方微博

知乎:TestOps-云层

(0)

相关推荐

  • Python实现数据技术|爬虫便可获取免费百度文库付费文档

    相信大家在百度文档中看到了比较合适的文档之后就有了想下载学习一下的想法,但是有些时候文章更多的需要付费下载,针对于文档中能发现语句是分为一个一个的标签中的文本进行输出的.如果你有耐心和任劳任怨的想法, ...

  • 1.2 selenium3和chrome环境

    selenium环境安装

  • 使用 VS Code 调试 Node.js 的超简单方法

    前端技术优选 以下文章来源于掘金开发者社区 ,作者iceytea 掘金开发者社区掘金,一个帮助开发者成长的技术社区 原文地址:The Absolute Easiest Way to Debug Nod ...

  • 好用的插件哪里找?大神帮你整理好了!

    官网:www.youquhome.cn 老Y在之前的文章中给大家推荐过不少神奇好用的chrome浏览器插件,其实早就有大神整理了超级多牛X的插件,下面老Y就给大家着重介绍下. 谷粒-chrome插件英 ...

  • 司马懿的两位女婿:一个是荀彧之孙,一个参加灭吴之战!

    司马懿一共有九个儿子,这九个儿子分别如下: 1.晋景帝司马师,张夫人生: 2.晋文帝司马昭,张夫人生: 3.平原王司马干,张夫人生: 4.汝南文成王司马亮,伏夫人生: 5.琅邪武王司马伷,伏夫人生: ...

  • 如何选择一个可信赖的开发商和一个靠谱的好项目?

    地盘说 现在,是郑州历史以来最好的时代,正在迈向更好的时代. 你主动或被动,情愿或被迫,时代的洪流滚滚向前,带着我们走向原本就期待的美好生活. ■ 撰文 | 李寻欢  ☞ <地盘>特邀撰稿 ...

  • 开发一个产品,就是开发一门新的生意

    产品是载体,商业成功才是目标.华为有一条非常著名的流程,就是"集成产品开发流程"(英文缩写是IPD).这是跟IBM学来的,华为为此光咨询费就掏了20亿元,而且,这可是1998年时的 ...

  • 卡米耶·毕沙罗,印象派大师,唯一一个参加...

    卡米耶·毕沙罗,印象派大师,唯一一个参加了印象派所有8次展览的画家.不管外界有多大压力,也不管内部有多大纷争,毕沙罗始终静静坚守,吸引了塞尚.高更.修拉.西涅克等后来名垂艺术史的印象派代表人物参加联展 ...

  • 坐标深圳,最近面试了一个求职者,软件开发...

    坐标深圳,最近面试了一个求职者,软件开发岗,提供月薪2-3万. 让人感慨的是,对方42岁,失业半年多,老婆没工作,家里一个孩子,每月要还房贷1万8,长期的失业让他的储蓄近乎见底,导致他心情很低落. 之 ...

  • 通达信——【黑脸关公】这是一个参加过指标...

    通达信--[黑脸关公]这是一个参加过指标大赛的作品,也获过奖,比较小众的一个指标. 我个人比较喜欢的一个,很精准,信号稳定.我用这个指标多次抓到涨停板.我个人感觉比现在的指标更合适我自己,适合自己的才 ...

  • 一个程序员的开发习惯(ZT)

    有关开发习惯的一些想法,如鲠在喉,不吐不快.究其发贴动机,当然不排除有骗取参与分的可能,但另一方面,也希望能给同行(念Xing)者提供一些建议,或者参考(希望不是误人子弟).同时,也希望各位能够就我的 ...

  • 百度提出PADDLESEG:一个高效的图像分割开发工具

    重磅干货,第一时间送达 小白导读 论文是学术研究的精华和未来发展的明灯.小白决心每天为大家带来经典或者最新论文的解读和分享,旨在帮助各位读者快速了解论文内容.个人能力有限,理解难免出现偏差,建议对文章 ...

  • 一个参加培训的工程师分享-他所在公司的精益推行

    我在做外部培训时,小赵同学诉说到:在加入某公司做精益工程师后,了解到公司是刚刚起步做精益,来了之后,才发现公司运营多年,改善的文化和相关的知识,人才储备相对匮乏,甚至连基本的标准工时等数据都缺失,作业 ...