注意内容重要内容

欢迎来到社区！

Circuit Python是一种非常简单入门且非常适合学习的编程语言。它可以在微控制器上运行，并且开箱即用。你可以将其连接并使用任何文本编辑器开始使用。最好的部分是，Circuit Python拥有一个令人惊叹且支持广泛的社区。

Circuit Python是开源的。这意味着任何人都可以使用、编辑、复制和改进它。这也意味着Circuit Python因为有你的参与而变得更好。无论这是你的第一个微控制器板还是你是一名经验丰富的软件工程师，你都可以为Adafruit Circuit Python社区做出重要贡献。本页面突出显示了你可以参与其中的许多方式！

Adafruit Discord（老外的QQ群）

Adafruit Discord服务器是开始的最佳地方。Discord是社区志愿者提供各种实时支持的地方。从一般讨论到详细问题解决，以及各种各样的主题，Discord是一个数字创客空间，汇聚了来自世界各地的创客。 

有许多不同的频道，因此你可以选择最适合你需求的一个。每个频道在Discord上显示为“#channelname”。有一个#​help-with-projects频道，用于协助你解决当前项目的问题或帮助你想出下一个项目的主意。有一个#show-and-tell频道，用于展示你的最新创作。不要害怕在任何频道中提问！如果你不确定，#general是一个很好的起点。如果另一个频道更可能为你提供更好的答案，会有人指导你。

有关Circuit Python问题，请前往Circuit Python问题帮助频道。#help-with-circuitpython专为新用户和开发人员提供，因此请随时提出问题或发表评论！任何经验水平的人都可以加入对话。你的贡献非常重要！#circuitpython-dev频道也可用于开发讨论。

为社区做出贡献的最简单方式是在Discord上帮助其他人。支持他人并不总是意味着回答问题。参与庆祝成功！庆祝你的错误！有时，只是听到别人经历了类似的困难足以使一个创客继续前进。

Adafruit Discord是一个24x7x365（996都不敢想，全年无休）的黑客空间，你可以带你的孙女来参观（老外的茬不懂）。

访问https://adafru.it/discord以注册Discord。大家都期待着与你见面！

CircuitPython.org

除了你正在查看的Adafruit Learn系统之外，关于Circuit Python的信息的最佳来源是circuitpython.org。你可以在那里找到一切关于开始使用新微控制器及更多的信息。你可以下载适用于你的微控制器的Circuit Python(https://circuitpython.org/downloads)，或者下载最新的Circuit Python库包(https://circuitpython.org/libraries)，或者查看支持Blinka的各种开发板(https://circuitpython.org/blinka)。你还可以访问各种与CircuitPython相关的内容，如Awesome Circuit Python或Python for Microcontrollers通讯简报。这一切都非常有用，但不一定与社区相关。那为什么包括在这里呢？因为有贡献页面(https://circuitpython.org/contributing)。

Circuit Python本身是用C语言编写的。但是，所有Adafruit Circuit Python库都是用Python编写的。如果你有兴趣为Circuit Python的Python方面做出贡献，请查看circuitpython.org/contributing。你将找到与每个Adafruit Circuit Python库GitHub存储库相关的信息，从而有机会通过找到适合你的贡献选项加入社区。

请注意页面上“Current Status”旁边的日期：

如果你向库提交了任何贡献，但在Contributing页面上没有看到它们的反映，那可能是检查新更新的作业尚未运行。只需明天再来查看！

现在，让我们看看不同的选项。

Pull Requests

你将找到的第一个选项卡是一个打开的拉取请求列表。

GitHub拉取请求，或PR，是在某人向Adafruit Circuit Python库GitHub存储库添加了内容并要求Adafruit将其更改合并到主要库代码中时打开的。要合并PR，必须首先进行审查。审查是一种很好的贡献方式！查看打开的拉取请求列表，并选择一个你感兴趣的请求。如果你有硬件，可以测试代码更改。如果没有，你仍然可以检查代码更新的语法。对于文档更新，你可以验证信息或检查拼写和语法。一旦你检查了更新，你可以留下评论，让我们知道你已经查看了。一旦你做了一段时间，并且感到更加自在，你可以考虑加入Circuit Python Librarians审查团队。我们拥有的审查员越多，我们就可以支持的作者越多。审查是开源生态系统的关键组成部分，包括Circuit Python在内。

Open Issues

你将找到的第二个选项卡是一个打开的问题列表。

GitHub问题是由许多原因而创建的，包括库或示例代码中存在错误或故障时，或者当有人想提出功能请求时。问题是通过更新代码或文档来直接为库做出贡献的绝佳方式。如果你有兴趣贡献代码或文档，请查看打开的问题，并找到一个你感兴趣的问题。

如果不确定从何开始，可以按标签搜索问题。标签被应用于问题上，以使目标在第一次看时更容易识别，或者表示问题的难度级别。单击“按问题标签排序”旁边的下拉菜单以查看可用标签列表，然后单击其中一个以选择它。

如果你对一切都不熟悉，不熟悉对参与开源贡献，或者不熟悉对Circuit Python项目的贡献，你可以选择“Good first issue”。带有该标签的问题定义明确，范围有限，适合新手解决。

如果你想要更复杂一些的东西，可以考虑“Bug”或“Enhancement”。Bug标签适用于与库中的问题或故障有关的问题。Enhancement标签适用于功能请求。

不要让过程吓倒你。如果你对Git和GitHub是新手，有一份指南(https://learn.adafruit.com/contribute-to-circuitpython-with-git-and-github)可以引导你完成整个过程。此外，Discord上始终有人可以回答你的问题(https://learn.adafruit.com/welcome-to-circuitpython/adafru.it/discord)。

Library Infrastructure Issues

你将找到的第三个选项卡是一个库基础结构问题列表。

此部分由运行库的检查的脚本生成，然后报告可能存在问题的地方。它由包含指向正在经历特定问题的存储库的链接的子部分列表组成。这一页主要供内部使用，但你可能会发现一些贡献机会。如果有列出的问题听起来是你可以帮助解决的问题，请在Discord上提及它，或在GitHub上提交问题，指出你正在努力解决该问题。其他人可以通过任何方式回复，以让你知道问题的范围可能是什么，并在必要时帮助你解决它。

CircuitPython本地化

你将找到的第四个选项卡是CircuitPython本地化选项卡。

如果你会说其他语言，你可以帮助翻译Circuit Python！翻译适用于Circuit Python核心中包含的信息性和错误消息。这意味着不会说英语的人在使用Circuit Python时有机会以其自己的语言看到这些消息。这对于为所有用户提供最佳体验非常重要。Circuit Python使用Weblate进行翻译，这使得贡献翻译变得更加简单。你仍然需要了解一些关于Circuit Python特定实践和一些有关编写字符串的基础知识，但与任何Circuit Python贡献一样，人们会提供帮助。

无论你的技能水平如何，或者你想如何为Circuit Python项目做出贡献，都有机会可用。Contributing页面是一个很好的起点！

Adafruit GitHub

无论你是初学者还是一生的程序员，都有适合每个人参与Circuit Python项目的方式。Circuit Python核心是用C编写的。库是用Python编写的。GitHub是为Circuit Python核心和Circuit Python库提供贡献的最佳来源。如果你需要帐户，请访问https://github.com/并注册。

如果你对GitHub或编程总体都不熟悉，那么对你来说有很好的机会。对于Circuit Python核心，前往GitHub上的Circuit Python存储库，单击“Issues”，你会找到一个包含标记为“good first issue”的问题的列表。对于库，前往Contributing页面的问题列表，并使用下拉菜单搜索“good first issue”。这些问题被确定为任何经验水平的人都可以帮助解决的问题。这些问题包括更新文档、提供反馈和修复简单的错误。如果你需要帮助开始使用GitHub，Contributing to Circuit Python with Git and GitHub上有一份出色的指南。

已经有经验并寻找挑战吗？查看其他问题列表，你会找到许多贡献的方式。你会发现各种各样的东西，从新的驱动程序请求到库错误，再到核心模块更新。对于任何水平的每个人都有大量的机会！

当使用Circuit Python或Circuit Python库时，你可能会遇到问题。如果发现错误，那太好了！团队喜欢错误！向GitHub提交详细的问题是改进CircuitPython的宝贵方式。对于Circuit Python本身，请在这里提交问题。对于库，请在GitHub上的特定库存储库上提交问题。请确保包括复制问题的步骤以及你认为相关的任何其他信息。细节越多越好！

测试新软件非常简单且非常有帮助。只需将CircuitPython的最新版本或库加载到你的Circuit Python硬件上并使用它。通过将新问题发布到GitHub来告诉我们你发现的任何问题。在稳定和不稳定版本上进行软件测试是贡献Circuit Python的非常重要的一部分。开发人员无法自己找到所有问题！他们需要你的帮助来使Circuit Python变得更好。

在GitHub上，你可以提交功能请求、提供反馈、报告问题等等。如果有问题，请记住Discord和论坛都可以提供帮助！

Adafruit论坛

Adafruit论坛是支持的最佳地方。Adafruit拥有出色的付费支持人员，可以回答你可能遇到的任何问题。无论你的硬件是否出现问题还是你的代码似乎无法正常工作，论坛始终都在等待你提问。你需要一个Adafruit帐户才能在论坛上发布。你可以使用在Adafruit订购时使用的同一个帐户。

尽管Discord可能会为你提供比论坛更快的响应，但论坛是更可靠的信息来源。如果你想确保获得由Adafruit支持的答案，论坛是最好的地方。

有涵盖各种主题的论坛类别，包括Adafruit的一切。在“Supported Products & Projects”下的Adafruit Circuit Python类别是发布Circuit Python问题的最佳地点。

确保包括你采取的步骤以到达你所在的位置。如果涉及布线，请发布一张图片！如果你的代码给你带来麻烦，请在你的帖子中包含代码！这是确保有足够信息帮助你解决问题的绝佳方法。

你可能认为你刚刚开始，但你绝对知道有些事情是其他人不知道的。论坛的好处在于你也可以帮助其他人！欢迎并鼓励每个人向发布的问题提供建设性的反馈。这是为社区做出贡献并分享你的知识的绝佳方式！

Read the Docs

Read the Docs是深入了解Circuit Python核心和Circuit Python库的细节的绝佳资源。这是你将找到API文档和示例代码等内容的地方。要详细了解查看和理解Read the Docs，请查看Circuit Python Documentation页面(https://learn.adafruit.com/welcome-to-circuitpython/circuitpython-documentation)！