第二周,我不得不花更少的时间寻找问题。这次是 Mattermost 文档网站在深色模式下发生的错误,其中特定按钮的颜色不正确。
我知道 Docusaurus,因为我看过其他文档和基于它构建的一些课程材料网站。它在底层使用了 React,所以我很熟悉它。但这个文档网站是用 Python 编写的。虽然我不是 Python 的粉丝,但它引起了我的兴趣,因为它不仅是用 Python 编写的,更具体地说是使用 Sphinx,它利用 reStructuredText 作为其标记语言。里面也有Makefile。很多新东西,但看起来很有趣。
所以我想解决这个问题。在表达了我的兴趣并将问题分配给我后,我开始研究它。尽管设置过程非常简单,并且脚本可以自动完成大部分工作,但我还是遇到了一些小问题。我使用 WSL(Windows Subsystem for Linux)作为我的开发环境。虽然我在 WSL 中同时拥有 python 版本 2.7 和 3.10,但我无法将其设置为 3.10 作为我的默认版本,并且由于我需要 Python 3.9 或更高版本来设置应用程序,所以我收到了错误。所以我在做了一些调查并找出罪魁祸首后,我切换到了我的本机 Windows 环境。之后就一帆风顺了。我有点惊讶整个编译时间有多长。花费的时间出奇的长,我怀疑是 python 造成的。对 conf.py 中特定按钮的样式进行调整,我必须重新编译,问题似乎已解决。
所以我的下一步是制作公关。在撰写 PR 描述时,我看到有指向 Mattermost 网站的链接,用于提供贡献指南,因此我必须注册并签署文档才能贡献,并使我的 github 帐户显示为贡献者。我阅读了进行适当公关的行规。完成所有事情后,我做了 PR,然后就是等待时间。截至撰写本文时,PR 仍然开放,即使已经过了 5 天。在我的代码审查被接受后,必须进行质量检查,这花费了最长的时间。在撰写本文时,代码审查和质量检查都已完成,因此合并和关闭只是时间问题。
在第二周,处理公司仓库并看到整个过程的展开是非常有趣的。虽然该项目是用 python 编写的,但它的工作却出奇的容易。
免责声明: 提供的所有资源部分来自互联网,如果有侵犯您的版权或其他权益,请说明详细缘由并提供版权或权益证明然后发到邮箱:[email protected] 我们会第一时间内为您处理。
Copyright© 2022 湘ICP备2022001581号-3