# Django 5.2.8 documentation

# 对新贡献者的建议

新来的贡献者，不知道该怎么办？ 想要提供帮助但是不知道如何开始？ 那这就是为你准备的部分。

开始并运行起来！

如果您是 Django 新的贡献者，那么 编写你的第一个 Django 贡献 教程将为您介绍这些工具和工作流程。

该页面包含有关您可以为 Django 做出贡献的更一般建议以及如何入手的信息。

如果你正在寻找关于代码贡献的细节参考，参见 贡献代码 文档。

## 快速入门

从这些任务开始，去发现 Django 的开发过程。

### 分类工单

If an unreviewed ticket reports a bug, try and reproduce it. If you can reproduce it and it seems valid, make a note that you confirmed the bug and accept the ticket. Make sure the ticket is filed under the correct component area. Consider writing a patch that adds a test for the bug's behavior, even if you don't fix the bug itself. See more at How can I help with development?.

### 审查已接受工单的补丁

这将帮助你熟悉代码库和流程。如果补丁需要文档或测试，请标记适当的标志。查看补丁所做的更改，并留意与较旧但仍受支持的 Python 版本不兼容的语法。运行测试 并确保它们通过。在可能和相关的情况下，尝试在 SQLite 以外的数据库上运行它们。留下评论和反馈！

### 保持旧补丁的最新状态

Oftentimes the codebase will change between a patch being submitted and the time it gets reviewed. Make sure it still applies cleanly and functions as expected. Updating a patch is both useful and important! See more on 贡献清单.

### 写文档

Django's documentation is great but it can always be improved. Did you find a typo? Do you think that something should be clarified? Go ahead and suggest a documentation patch! See also the guide on 编写文档.

Note

报告页 包含了许多有用的 Trac 查询链接，包括一些像上面建议的那样对分类工单和审查补丁有用的链接。

### 签署贡献者许可协议

您编写的代码属于您或您的雇主。 如果您的贡献超过一至两行代码，则需要签署 CLA 。 有关更详尽的解释，请参阅 Contributor License Agreement FAQ”。

## 方针

作为大型项目的新手，很容易感到沮丧。 这里有一些建议可以使你在 Django 上的工作更加有用、 有收获。

### 选择一个主题领域

这应该是你关心的、熟悉的或想要学习的内容。你不必已经是你想从事领域的专家；通过持续对代码的贡献，你会成为专家。

### 分析工单的背景和历史

Trac不是绝对的；上下文和名词一样重要。在阅读Trac时，你需要考虑到账户谁说了什么，什么时候说的。两年前对一个想法的支持并不意味着这个想法还会得到支持。您还需要注意哪些人没有发言--例如，如果一位有经验的贡献者最近没有参与讨论，那么这份工单可能就不需要Django支持。

### 从小处着手

在小问题上得到反馈比在大问题上得到反馈要容易得多。请参阅 easy pickings。

### 在从事大任务之前确认支持

这意味着在您解决问题之前让其他人确认一个bug是真实的，并确保在您开始实现一个建议的特性之前有一个共识。

### 大胆一点！留下反馈！

有时候，把你的观点向全世界发表，说“这个工单是正确的”或者“这个补丁需要工作”，这可能会让人害怕，但这是项目向前推进的唯一途径。广泛的Django社区的贡献最终会比任何一个人的贡献产生更大的影响。没有**你**我们做不到！

### 在标记“准备检入”时要谨慎

如果你真的不确定某个工单是否准备好了，不要将其标记为准备就绪。相反，留下评论，让别人知道你的想法。如果你基本确定，但还不完全确定，你也可以尝试在 Django Discord 服务器 的 `#contributing-getting-started` 频道中询问，看看是否有人可以确认你的怀疑。

### 等待反馈，并对收到的反馈做出回应

专注于一两张工单，从头到尾看完，然后重复。短期途径接手很多工单，让一些工单在半路上掉下来，这样做的结果是弊大于利。

### 严谨细致

当我们说“PEP 8，并且必须有文档和测试”时，我们是认真的。如果一个补丁没有文档和测试，最好有一个充分的理由。诸如“我找不到该功能的任何现有测试”之类的论点没有多大分量。虽然这可能是真的，但这意味着你有一个额外重要的任务，即为该功能编写第一个测试，而不是完全免于编写测试。

### 保持耐心

您的工单或补丁可能无法立即得到快速审查，并非出于个人原因。有很多工单和拉取请求需要处理。

保持你的补丁最新是很重要的。在你解决了所有的审查意见后，请查看 Trac 上的工单，确保 需要测试、需要文档 和 补丁需要改进 的标志都被取消选中。

请记住，Django 的发布周期为八个月，因此您的补丁有足够的时间进行审查。

最后，一个及时的提醒可能会有所帮助。请参考 贡献代码 FAQ 来获取一些想法。