在日常的开源项目或团队协作中，我们经常会需要一个易于维护、可自动部署的文档系统。
最近在维护自己的开源项目时，我尝试用 Sphinx 来生成文档，并通过 ReadTheDocs 实现了自动构建和托管，整体体验还不错。
记录一下配置过程，希望能帮到有类似需求的朋友。
这两个工具的组合非常适合持续维护和更新文档，而且社区成熟、资料丰富。
在日常工作中，无论是写 README、写博客，还是写项目文档，我们总要选择一种标记语言来排版内容。
目前主流的有两种：Markdown 和 reStructuredText（简称 RST）。
那它们之间到底有什么区别？又该在什么场景下选哪个呢？
最近我将 gitstats 项目的文档从 Markdown 转换为 RST，并发布到 ReadTheDocs 上，这篇文章就来聊聊我的一些实践体会。
回国两个月来，我一直想写一篇文章，来记录一下这两个月来的生活。
但我每次敲击键盘总是写了又改，改了又删。
我时而想写下所有的我能记住的点点滴滴；时而又想写下我临行前的心情，但我不想让家人担心。
这两次出国前，我总爱听赵雷的《我记得》。
这个歌会让我回想起来这每一天，每一周，每一月的生活。
如果你是 VMware 的企业用户，或许你正在考虑脱离 VMware。目前，许多企业用户正在积极寻找替代方案，以降低成本和减少对 VMware 生态的依赖。
很多企业在考虑脱离 VMware，主要原因是：
Broadcom（博通）收购 VMware 带来的影响。2023 年 Broadcom 完成了对 VMware 的收购，并进行了一系列调整，包括：
这些变化导致很多企业开始寻找替代方案，以降低成本并减少对 VMware 生态的依赖。
昨晚，哄完女儿睡觉已经是午夜十二点了。我回到自己的屋里，打开 GitHub，看看当晚有没有什么可以贡献的项目。
这次，我决定去 CPython 的 Issue 区找找有没有适合自己的贡献机会。
CPython 就是大名鼎鼎的 Python 编程语言的官方代码仓库。
其实，早就想找机会为 CPython 贡献代码，但一直没能迈出第一步。这次，我想用自己的方式寻找突破口。
这种想法的启发，来自 Tian Gao（GitHub ID：gaogaotiantian），他是 Python 的 Core Developer（核心开发者），专注于维护 pdb，并曾跻身 Python 贡献排行榜 #94 名。他可能是唯一一个前 100 名的中国开发者。
于是，我筛选了一些自己感兴趣的类别，当然就是 Infra 和 DevOps 相关的问题。很快，我找到了一张合适的 Issue，修改代码、测试、提交 Pull Request，然后就去睡觉了。
今天早上醒来，我发现我的 PR 已经被 Merge 到 CPython 主分支了！
虽然这算不上什么了不起的成就，但却是一个很好的学习过程。比如，通过参与优秀的开源项目，了解他们是如何管理 Issue 和 Pull Request 的，学习他们做得好的地方。这些经验都有可能应用到自己的工作或项目中。
在贡献优秀开源项目的过程中，不仅能提升相关技能，还能与这些优秀的开发者交流，学到新的知识。
从短期来看，或许不会带来直接的收益，但如果这是你真正热爱的事情，那么长期投入一定是值得的。
假如拥有 Python Core Developer 这样的身份认可，在国内可能有助于获得更理想的工作机会。然而，并非所有公司都青睐这种“双时区开发者”（白天工作，晚上开源）。
但如果你的目标是寻找远程工作，或者申请欧美国家的签证，这样的经历无疑会成为一个重要的加分项。
转载本站文章请注明作者和出处，请勿用于任何商业用途。欢迎关注公众号「DevOps攻城狮」
最近工作之余没怎么贡献代码，主要把时间都用在了评审 EuroPython 2025 （欧洲 Python 2025 大会）的提案上了。
在国内的时候，我从未想过去参与某个活动，并当志愿者服务大家。但是来到欧洲，我突然想多参加点这样的活动。
下面就说说我为什么选择参加志愿者工作，以及最近一周的支援活动有哪些收获和感悟。
Recently, I am working on Jenkins instance migration, this time I started to use Jenkins Docker Cloud insead of use docker { ... } in Jenkinsfile.
First you need to install Jenkins Docker Cloud plugin https://plugins.jenkins.io/docker-plugin/
Jenkins Docker Cloud is a plugin that allows Jenkins to use Docker containers as build agents.
So you need to config a Docker Host with remote API as follows.
最近的晚上的时间（一般要等到孩子睡了）我正在做一件事：复活已经沉寂多年的 GitStats 项目。
此前，我曾写过两篇关于 GitStats 的文章，如果感兴趣，可以查阅了解。
当 CI 或更糟的是生产发生灾难性故障时，“在我的计算机上工作”一直是毫无帮助的答案。除其他外，Nix 是一种通过提供可重复、声明性和可靠的系统来解决此问题的方法。这使得它成为通常称为 DevOps 的两个方面的绝佳工具：操作系统的开发和流程。这篇文章将通过一个实际示例展示这两个方面，但首先，让我们从鸟瞰的角度看看这些承诺到底意味着什么。
最近有用户提出两个需求：一是支持在 Pull Request 中增加评论，二是检查 Pull Request 是否已经 rebase。
经过几晚的努力，现在正式宣布在最新的 commit-check 以及 commit-check-action 中新增两个重要功能：pr-comments 和 base-merge。
这两个功能旨在进一步提升 Pull Request (PR) 的检查能力。