Skip to main content

对新贡献者的建议

新的贡献者,不知道该怎么办?想要帮助,但只是不知道如何开始?这是你的部分。

基本工具和工作流程

如果你是新的贡献Django,编写Django的第一个补丁 教程将给你介绍工具和工作流。

第一步

开始这些简单的任务,以发现Django的开发过程。

  • 签署贡献者许可协议

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

  • 检票

    如果 unreviewed ticket 报告错误,请尝试并重现它。如果你可以重现它,它似乎有效,请注意,你确认错误并接受机票。确保票据存储在正确的组件区域下。考虑写一个补丁,为bug的行为添加一个测试,即使你不修复bug本身。查看更多 我如何帮助分类?

  • 查找接受的票证,并查看修补程序以熟悉代码库和过程

    如果补丁需要文档或测试,请标记相应的标记。查看修补程序所做的更改,并留意与旧版本但仍支持的Python版本不兼容的语法。 运行测试 并确保他们通过。在可能和相关的情况下,在除SQLite之外的数据库上尝试。留下评论和反馈!

  • 保持最新的旧补丁

    通常,代码库将在提交的修补程序和审核时间之间更改。确保它仍然适用,并按预期工作。简单地更新补丁既有用又重要!查看更多 提交修补程序

  • 写一些文档

    Django的文档是伟大的,但它可以随时改进。你发现有错字吗?你认为应该澄清什么吗?继续并建议一个文档补丁!另见 编写文档 指南。

    注解

    reports page 包含许多有用的Trac查询的链接,包括几个如上所述的用于分类票证和审查补丁的有用的。

指南

作为一个大型项目的新手,很容易感到沮丧。这里有一些建议,使您的Django上的工作更有用和有益的。

  • 选择您关心,熟悉或想要了解的主题领域

    你不必是你想工作的领域的专家;您将通过您对代码的持续贡献成为一名专家。

  • 分析票证的上下文和历史记录

    Trac不是绝对的;语境与语言一样重要。当读Trac时,你需要考虑谁说的事情,当他们说。两年前支持一个想法并不一定意味着这个想法仍然会有支持。你还需要注意谁 hasn’t 说 - 例如,如果核心团队成员最近没有参与讨论,那么票可能不需要支持进入中继。

  • 开始小

    在一个小问题上比在一个大问题上获得反馈更容易。见 easy pickings

  • 如果你要从事一项很大的任务,首先要确保你的想法有支持

    这意味着在解决问题之前让别人确认错误,并确保核心团队在实施之前支持提议的功能。

  • 大胆!留下反馈!

    有时,将你的意见告诉世界并说“这张票是正确的”或“这个补丁需要工作”可能是可怕的,但它是项目向前迈进的唯一方式。广泛的Django社区的贡献最终比核心团队的影响大得多。我们不能没有

  • Err在标记时谨慎一侧准备入住

    如果你真的不确定票是否准备好了,不要标记为这样。发表评论,让别人知道你的想法。如果你确定,但不完全确定,你也可以尝试问IRC,看看是否有人可以确认你的怀疑。

  • 等待反馈,并回复您收到的反馈

    专注于一张或两张票,从开始到结束,看他们,并重复。猎枪的方法,拍摄很多票,让一些跌倒在路边结束了更多的危害比好。

  • 要严谨

    当我们说“ PEP 8,并必须有文档和测试”,我们的意思。如果补丁没有文档和测试,最好有一个很好的理由。 “我找不到这个功能的任何现有测试”这样的参数没有任何重要性 - 虽然它可能是真的,这意味着你有非常重要的工作,为该功能编写第一个测试,而不是你会得到一个通过从书面测试完全。

常问问题

  1. 我关心的这张票已被忽略了几天/周/月!我能做什么来让它承诺?

    首先,它不是个人的。 Django完全由志愿者(即使是核心团队)开发,有时候人们没有时间。最好的办法是向 django-developers 邮件列表发送一个温和的提醒,要求对该票进行审核,或者在 #django-dev IRC频道中提出。

  2. 我相信我的票是绝对100%完美,我可以标记为RFC自己吗?

    简短的答案:不。总是更好地在票上得到另一组眼睛。如果你无法获得第二套眼睛,请参阅上面的问题1。