跳转至主要内容

Conda-forge Outreachy

·6 分钟阅读
Vinicius Douglas Cerutti
Vinicius Douglas Cerutti
conda-forge/core 成员

Conda-forge 正在参与即将到来的 Outreachy 轮次，即 2021 年 5 月至 2021 年 8 月。该计划的目标是提高代表性不足的群体在自由和开源软件中的参与度。Outreachy 由 软件自由保护组织组织。

参与者申请流程：​

首先，请查看 Outreachy 资格和申请信息页面，以了解有关 Outreachy 资格的更多信息。

conda-forge 申请人的步骤：​

  1. 在 Outreachy 网站上确认您的资格
  2. 查看 Outreachy 网站上提供的 Conda-forge 项目，考虑您的选择，如果您有疑问，请与项目导师沟通。
  3. 首先，通过查看我们的 问题页面来为项目做贡献。当您做出贡献时，请在 Outreachy 网站上记录下来。
  4. 在您做出一些贡献后，开始撰写您的申请。在您提交申请之前，请导师审核申请。

参与者期望​

您将全职从事您的项目三个月。您将经常与您的导师会面，并参与开源开发过程——编写代码、审查代码、测试等等。您将被期望每周写一篇博客文章。

项目贡献信息​

作为申请流程的一部分，所有申请人必须至少做出一个贡献才能被接受为该项目的实习生。只有做出贡献的申请人才有资格被接受为实习生。

虽然我们没有明确要求，但我们强烈建议首次贡献者成为 conda 用户和/或通过 staged-recipes 向 conda-forge 提交软件包。这将确保贡献者理解我们所做工作的价值，并意味着他们愿意参与我们的社区。

申请人可以通过 项目存储库或贡献页面 为该项目做出贡献。该项目使用 问题跟踪器 来保存有关要修复的错误、要实现的项目功能、要编写的文档等信息。申请人可以通过在项目问题 跟踪器 中查找以下问题标签来查找新手友好的问题以用于他们的首次贡献：Docs、Good first issue

我们在 conda-forge 这里有大量潜在的 Outreachy 工作，围绕文档、维护和开发。这些任务具有高影响力，影响整个 conda-forge 生态系统。它们还涵盖多个系统，包括数据库、conda 的 CDN 提供商、持续集成提供商以及 GitHub 上的用户交互。

我如何与 conda-forge 社区合作？​

Outreachy 申请人可以从导师和社区成员那里获得帮助和反馈。社区成员在公共聊天中讨论他们的贡献。Outreachy 申请人通常可以从这些讨论中学习。

请在公共项目聊天中介绍你自己

  • Gitter - 点击此链接 加入该项目的公共聊天。
  • Outreachy 导师通常会在社区公共聊天中。项目导师的用户名是：@viniciusdc。

以下是一些您可以立即开始自行贡献的准备就绪的方法。

  • 查找要解决的未解决问题或向问题跟踪器报告错误；
  • 不要害怕沟通：询问您是否可以帮助编写新功能或帮助自动化项目设置；
  • 改进当前工具和测试功能始终受欢迎。

由于该项目的主要目标是增强我们当前的文档，以下是一些您可以检查以获取想法的初步任务

  • 编写和改进项目文档；
  • 链接到重复的问题，并建议新的问题标签，以保持井井有条；
  • 浏览未解决的问题并建议关闭旧问题；
  • 在最近打开的问题上提出澄清问题，以推动讨论向前发展；
  • 我们还有关于我们的机器人的主要功能的issue，特别是 autotick 机器人。您可以为您的贡献提案找到一些新信息或想法。

良好的入门任务：​

小型入门任务​

与大多数组织一样，有很多小问题需要解决，通常与诸如错误的 recipes、旧文档等问题有关。这些将成为解决或“更新”的良好首要问题。这也将是熟悉 conda-forge 环境的机会。

更大的任务​

在完成一些较小的任务贡献之后，可能会有一些潜在的更大的任务。这些任务包含在我们的三个主要基础中

  • 用户：在这种情况下，一些好的入门任务主要是检查 conda-forge 用户文档的实际内容，以及更好地表达其内容的想法。
  • 维护者：在这个领域有很多遗漏的主题，一些信息必须更新或重写以获得更好的理解。编写一个完整的指南，其中包含软件包 recipe 的实际步骤和标准模型、构建过程（只是一个简单的讨论），以及 conda-forge 机器人如何识别有缺陷的许可证、recipes 和软件包，这将非常受欢迎。为了进一步了解一般系统，请查看 此链接。
    • 说起来可能很有趣，但在我们的 gitter 频道上出现了很多有用的想法和错误解决方案，所以如果您有时间编写关于它们的指南...这也是一项不可思议的任务。
  • 和组织 我们的环境每天都在变化，因此，很多信息在这个过程中丢失了，甚至更糟的是，根本没有记录下来！这导致新成员难以加入以开发和进一步增强当前流程。
    • 在这件事上的相关工作非常受欢迎，为了更好地掌握情况，您可以从这份 指南 开始，并阅读我们 博客 中的一些文章
    • 绝对欢迎振兴 conda-forge 博客的想法/项目；
    • 目前，我们的生态系统中正在进行一些有趣的项目，这些项目反过来将需要良好的文档... conda-forge 附属的一些项目包括 auto-tick 机器人、symbol-exporter 和我们渴望开始开发的一项新服务 distributed-bot。所有这些都涵盖了广泛的主题，并且有很多人可以帮助并提供有关服务结构和功能的建议。

改进文档​

您可以帮助改进文档，因为它在 GitHub 上的 conda-forge.github.io 存储库中进行版本控制。源文本存储在 src/subdirectory 中，并使用 Python 的 reStructuredText 系统 进行格式化。

如果您在 GitHub 上有一个帐户，您可以直接通过 GitHub 网站提出快速编辑——例如，此 链接 将直接带您到我们 文档 中此部分页面的基于 Web 的编辑器。一般来说，GitHub 浏览器中每个页面对应的文件在其右上角都有一个小铅笔图标，可让您打开它进行编辑。

更手动的过程如下

  • 将 conda-forge.github.io 存储库 Fork 到您自己的 GitHub 用户帐户。
  • 将该 Fork 克隆到您的计算机上。
  • 检出一个从 master 派生的新分支来完成您的工作。
  • 进行并提交您的更改。
  • 提交拉取请求到主存储库以提议您的更改。

编辑愉快！