新的贡献者,不确定该怎么做?想帮忙但不知道怎么开始?这是给你的。
站起来,跑起来!
如果你刚开始为Django做贡献, 为Django撰写第一篇文章 教程将向您介绍工具和工作流。
这一页包含了更多关于如何为Django做出贡献以及如何实现的一般性建议。
如果您正在寻找有关编写代码的详细信息的参考资料,请参阅 贡献代码 文件。
从这些步骤开始,了解Django的开发过程。
如果一个 unreviewed ticket 报告一个错误,尝试复制它。如果您可以复制它,并且它看起来是有效的,那么请记下您确认了错误并接受了票据。确保票据在正确的组件区域下归档。考虑编写一个补丁来添加对bug行为的测试,即使您不修复bug本身。更多见 我如何帮助试诊?
这将帮助您熟悉代码库和流程。如果补丁需要文档或测试,请标记相应的标志。查看补丁所做的更改,并注意与旧版本但仍受支持的Python不兼容的语法。 Run the tests 并确保他们通过。如果可能且相关,请在SQLite以外的数据库上尝试它们。留下评论和反馈!
通常,代码库会在提交补丁和审查之间发生变化。确保它仍然清晰地适用并按预期发挥作用。更新补丁既有用又重要!看到更多关于 提交捐款 。
Django的文档很好,但它总是可以改进的。你发现打字错误了吗?你认为应该澄清一些事情吗?继续建议文档修补程序!另请参见上的指南 编写文档 .
备注
这个 reports page 包含指向许多有用的TRAC查询的链接,其中包括一些对于筛选票据和查看上面建议的补丁程序有用的链接。
你写的代码属于你或你的雇主。如果您的贡献超过一行或两行代码,则需要在 CLA . 见 Contributor License Agreement FAQ 更详细的解释。
作为一个大型项目的新人,很容易感到沮丧。以下是一些建议,让你在 Django 的工作更有用,更有益。
这应该是您关心、熟悉或想了解的事情。您不必成为您想要工作的领域的专家;您可以通过对代码的持续贡献成为专家。
trac不是绝对的;上下文和单词一样重要。阅读TRAC时,你需要考虑到谁说了什么,以及他们什么时候说了什么。两年前对一个想法的支持并不一定意味着这个想法仍然会得到支持。你还需要注意谁 还没有 口语——例如,如果一个有经验的投稿人最近没有参与讨论,那么一张票可能没有进入Django所需的支持。
在小问题上得到反馈比在大问题上容易。见 easy pickings .
这意味着在修复问题之前让其他人确认一个bug是真实的,并确保在您开始实施它之前,就一个提议的特性达成共识。
有时候,把你的观点告诉世界,说“这张票是正确的”或者“这个补丁需要工作”,可能会很可怕,但这是项目前进的唯一方式。广大Django社区的贡献最终会比任何一个人产生更大的影响。我们不能没有 you 你说什么?
如果您确实不确定门票是否准备好,请不要这样标记。请留下评论,让其他人知道你的想法。如果您基本确定,但不完全确定,您也可以尝试在 #contributing-getting-started 通道 Django Discord server 看看其他人是否可以证实您的怀疑。
把注意力集中在一两张票上,从头到尾看一遍,然后重复。拿了很多票,让一些票掉在路边的散弹枪方法,结果弊大于利。
当我们说“:pep:',并且必须有文档和测试”时,我们是认真的。如果补丁没有文档和测试,最好有一个充分的理由。像“我找不到该功能的任何现有测试”这样的论点没有太大分量。虽然这可能是真的,但这意味着您有一项特别重要的工作,那就是为该功能编写第一个测试,而不是完全编写测试就能通过。
要快速查看您的机票或补丁并不总是那么容易。这不是私人恩怨。有很多门票和拉票请求才能通过。
让您的补丁保持最新很重要。检查Trac上的票证以确保 Needs tests , Needs documentation ,以及 Patch needs improvement 一旦您处理了所有的评论评论,标志就会被取消选中。
记住,Django有八个月的发布周期,所以有足够的时间来审查你的补丁。
最后,适时的提醒可能会有所帮助。看见 contributing code FAQ 在这里寻找点子。
5月 28, 2025