关注 Python 的开发¶
Python 的开发通过多种方式进行交流,主要通过 Discourse 以及其他平台。
这些交流渠道中的行为标准¶
我们尝试营造相互尊重、宽容和鼓励的环境,如 PSF 的多元化声明中所述。遵守此文档中的准则并在适当的渠道中提出问题或发布建议是开始相互尊重部分的绝佳方式,极大地增加了反过来获得宽容和鼓励的机会。
邮件列表¶
注意
某些邮件列表已被 Python Discourse 中的类别所取代。具体来说,
核心开发中的讨论重点关注与 Python 自身开发相关的问题,例如如何处理特定问题、PEP 等。
关于新功能的想法不应从这里开始,而应在想法中进行讨论。
也不应在此处提出技术支持问题,而应转到python-list或python-help邮件列表,或 Discourse 上的Python 帮助类别。
python-dev、python-committers和python-ideas邮件列表上的现有主题可以通过在线存档进行访问。
一般的 Python 问题应转到python-list或tutor或类似的资源,例如StackOverflow或Libera.Chat上的#python
IRC 频道。
core-workflow问题跟踪器是讨论和改进 CPython 核心开发工作流的地方。
可以在https://mail.python.org/mailman/listinfo(使用 Mailman2 的较旧列表)或https://mail.python.org/mailman3/(使用 Mailman3 的较新列表)找到 Python 邮件列表的完整列表。某些列表也可能在GMANE上镜像,并且可以通过多种方式进行阅读和发布,包括通过网络浏览器、NNTP 新闻阅读器和 RSS 订阅源阅读器。
Discourse(discuss.python.org 网络论坛)¶
我们有自己的Discourse论坛,供开发人员和用户使用。此论坛是对python-dev、python-ideas、python-help和python-list邮件列表的补充。
此论坛有不同的类别,大多数核心开发讨论都发生在PEPs和核心开发的开放论坛类别中(这些是 Discourse 等同于 python-dev 邮件列表)。除了提交者类别外,所有类别都向用户开放以供阅读和发布,提交者类别中的发布仅限于CPython核心开发人员。
提交者类别通常用于公告和通知。它也是核心开发人员晋升投票的指定场所。
新用户教程¶
要在论坛中发起主题或参与任何讨论,请使用电子邮件地址或 GitHub 帐户注册并创建一个帐户。您可以通过单击Discourse主页右上角的“注册”按钮来执行此操作。
Python Discourse 快速入门由Carol Willing编译,它概述了如何启动 Python Discourse。
我们建议新用户通过完成 Discobot 教程来熟悉论坛。这些教程可以通过回复用户帐户中的通知和消息下收到的“discourse 问候!”的欢迎消息来激活。
点击页面右上角的个人帐户。
下拉菜单将显示四个不同的图标:🔔(通知)、🔖(书签)、✉️(消息)和 👤(首选项)。
选择通知或消息。
打开 Discobot 发送的“问候!”消息以开始教程。
确保阅读Python 行为准则。我们必须对社区中的所有用户保持开放、体贴和尊重。您可以通过点击消息下的三个点,然后点击 ⚐ 图标来举报不遵守行为准则的消息。您还可以在消息中提及@staff、@moderators或@admins组。
阅读主题¶
点击主题标题并按时间顺序向下阅读回复列表,在阅读时关注链接或预览回复和引用。使用鼠标滚动屏幕,或使用右侧的时间线滚动条,它还显示您已阅读对话的进度。在较小的屏幕上,选择底部的进度条以展开它。
通知¶
关注类别(类别通知)¶
可以为各个类别和主题设置通知。要更改任何这些默认设置,您可以转到用户首选项,或访问类别页面,并使用类别页面右上角“+ 新主题”按钮旁边的主题列表上方的通知按钮 🔔。
点击通知控件 🔔 将显示一个下拉面板,其中有 5 个不同的选项:关注、跟踪、关注首帖、正常和静音。所有类别在默认情况下都设置为正常模式,在这种模式下,只有当有人提及您的 @name 或回复您时,您才会收到通知。
关注各个主题(主题通知)¶
要关注任何单个主题或主题串,您可以通过时间线末尾主题右侧的通知按钮 🔔 调整您的通知。您还可以在每个主题的底部进行此操作。选择“关注”,当该特定主题串有任何新的更新回复时,您将收到通知。
在用户首选项中自定义通知¶
要全面了解您所有自定义通知,您可以转到帐户首选项。这允许您根据类别、用户和标签进行调整。
启用邮件列表模式¶
在邮件列表模式下,您将收到每篇文章一封电子邮件,就像传统的邮件列表一样。如果您更喜欢通过电子邮件进行互动,而不访问论坛网站,这是很理想的。要激活邮件列表模式,请转到电子邮件首选项,选中“启用邮件列表模式”并保存更改。
Discord(私人聊天服务器)¶
对于更实时的讨论,核心开发团队有一个可用的私人 Discord 服务器。该项目的核心开发人员、指导委员会成员、分类人员和文档编制人员有资格加入该服务器。加入 Discord 服务器完全是可选的,因为所有必要的通信都发生在邮件列表和 Discourse 论坛中。
对于核心开发人员,可以在 Discourse 论坛的仅限核心开发人员的私人部分中找到此服务器的长效多用途邀请链接。
对于加入 Discord 服务器的分类人员和文档编制人员,应生成一次性邀请链接并直接发送给他们。
新用户首次加入服务器时,只能访问 #welcome
和 #rules-and-info
频道。核心开发者可以在 #welcome
频道发帖请求访问服务器的其他频道之前,在 Steering Council 🔒 选民记录 中使用 Discord ID 更新他们的项目角色。不想将 Discord ID 添加到 Steering Council 选民记录中的分类员、文档编写者和核心开发者,可以由 Discord 服务器的现有成员担保。
作为一个私有的、未存档的论坛,不应在 Discord 上做出有关设计和开发问题的最终决定。Discord 讨论的任何结论都应总结并发布到问题跟踪器、Discourse 论坛或邮件列表(分享结论的适当场所取决于具体讨论)。
注意:现有 Discord 用户可能希望在自动 Discord 欢迎消息中右键单击他们的用户名,然后选择“编辑服务器个人资料”以设置特定的 服务器昵称
IRC¶
一些核心开发者仍然参与 #python-dev
IRC 频道,位于 irc.libera.chat
。这不是寻求 Python 帮助的地方,而是讨论与 Python 自身开发相关的问题。另请参阅 #python-dev-notifs
频道,了解机器人的通知。
博客¶
几位核心开发者是活跃的博主,并以这种方式讨论 Python 的开发。你可以在 https://planetpython.org/ 找到他们的博客(以及使用 Python 的其他各种开发者)。
设定对开源参与的期望¶
由于对用户、贡献者和维护者彼此期望的误解,在开源中很常见。Brett Cannon 就此主题发表了 演讲,旨在帮助每个人设定对彼此的合理期望,以便让开源对每个人都变得愉快。
其他存储库¶
Python Core Workflow 托管了诸如 blurb 等工具的代码库。
其他核心工作流工具是
Python 性能基准 项目旨在成为所有 Python 实现的基准权威来源。