在 Devin 中试用 DeepWiki 处理私有仓库
DeepWiki

ripienaar/free-for-dev

菜单

贡献流程

相关源文件

本文档概述了为 free-for.dev 存储库贡献的流程和要求。该存储库是一个社区驱动的资源集合，为开发人员提供免费套餐，重点关注基础设施开发人员和 DevOps 从业人员。本文说明了如何提交新资源以添加到列表中，可接受提交的要求，以及创建和提交拉取请求的工作流程。

来源： README.md3-13

贡献流程概述

free-for.dev 存储库依赖社区贡献来维护一份最新的开发人员免费服务列表。贡献通过 GitHub 拉取请求进行管理，拉取请求会根据特定标准进行评估，以确保质量和相关性。本节提供了贡献工作流的概述。

贡献工作流程图

来源： README.md9-13 .github/PULL_REQUEST_TEMPLATE.md1-27

贡献流程包括识别免费 SaaS 资源，使用模板创建拉取请求，然后提交以供审核。维护者会根据要求验证提交内容，如果符合所有标准，则会将贡献合并到 README.md 文件中。

提交要求

一项服务要被接受到 free-for.dev 列表中，它必须满足几个特定的要求。这些要求确保列表保持有价值并专注于其预期目的。

关键要求清单

要求描述
仅限 SaaS提交的内容必须是软件即服务 (SaaS)，而不是自托管解决方案
免费套餐必须有真正的免费套餐，而不仅仅是免费试用
持续时间如果有限制时间，免费套餐必须至少持续一年
清晰的定价定价信息必须清晰可见，无需注册或电话联系
免费产品详情提交内容必须明确免费套餐中包含的内容
非重复该服务不得已存在于列表中
联系方式和隐私服务必须提供联系方式和隐私政策
安全TLS 不能仅限于付费套餐
相关性必须与基础设施开发人员和 DevOps 从业人员相关

来源： README.md13 .github/PULL_REQUEST_TEMPLATE.md29-40

提交类别

该存储库将资源组织成多个类别。提交新服务时，应将其放在 README.md 文件中的相应类别下。主要类别包括：

来源： README.md15-77

拉取请求工作流程

本节提供了有关如何创建和提交拉取请求以将新服务添加到 free-for.dev 列表的分步指南。

创建拉取请求

  1. Fork 存储库：将 free-for-dev 存储库 到你的 GitHub 帐户。

  2. 编辑 README.md 文件：在 README.md 文件中将你的提交添加到相应的类别。请遵循现有格式以保持一致性。

    * [service-name.com](https://service-name.com/) — Brief description of the service. Details about the free tier.

  3. 创建拉取请求：导航到原始存储库，并从你的 Fork 创建一个新的拉取请求。

  4. 使用 PR 模板：存储库包含一个拉取请求模板，当你创建新的 PR 时，该模板会自动填充。确保你已满足模板中列出的所有要求。

  5. 审查并处理反馈：维护者可能会要求进行更改或澄清。及时响应反馈以促进审查过程。

来源： .github/PULL_REQUEST_TEMPLATE.md1-40

PR 模板结构

PR 模板通过明确列出必须满足的要求来帮助指导贡献者完成提交过程。模板包含一个清单，用于确保：

  1. 提交的是 SaaS 产品，而非自托管产品
  2. 它提供免费套餐（不仅仅是试用）
  3. 定价信息清晰可见
  4. 提到了免费套餐的详情
  5. 提交内容不是重复的
  6. 服务提供联系方式和隐私政策

来源： .github/PULL_REQUEST_TEMPLATE.md29-40

提交指南和最佳实践

为了提高你的贡献被接受的机会，请遵循这些指南和最佳实践：

内容格式

  • 一致性：遵循 README.md 文件中的现有格式。
  • 简洁性：保持描述简短但信息丰富。
  • 清晰度：清楚地说明免费套餐中包含的内容。
  • 组织性：将你的提交添加到正确的类别。

不接受的服务

该存储库不接受特定类型的服务：

  • 类似 cPanel 的 PHP + MySQL 托管服务
  • 通用前端指向 CloudFlare 或类似服务的免费 DNS 服务
  • 与现有服务完全相同但没有增加价值的服务
  • 虚假/临时/一次性电子邮件生成器（列表中已足够）

来源： .github/PULL_REQUEST_TEMPLATE.md21-27

维护者酌情处理

存储库维护者对接受的内容拥有最终决定权。范围仅限于基础设施开发人员和 DevOps 从业人员认为有用的服务。此评估存在一定的主观性，维护者的决定是最终的。

来源： README.md7

行为准则

该存储库维护着一个简单的贡献者行为准则。

我们不会与你争论。如果你好争论、辱骂、撒谎或歪曲你的服务，或者有其他反社会行为，我们将屏蔽你。

此政策有助于为所有贡献者维护积极和建设性的环境。

来源： .github/PULL_REQUEST_TEMPLATE.md15-19

组件之间的关系

下图说明了贡献过程中涉及的各个组件之间的关系。

此图显示了贡献者如何使用 PR 模板创建拉取请求，该模板会验证提交要求。维护者会审查拉取请求并更新 README.md 文件，其中包含目录、类别部分和服务列表。

来源： README.md1-14 .github/PULL_REQUEST_TEMPLATE.md1-40

结论

free-for.dev 存储库的贡献流程旨在保持开发人员免费服务列表的质量和相关性。通过遵循本文档中概述的要求和指南，贡献者可以帮助扩展和改进这个有价值的开发人员社区资源。

该存储库是由 1,600 多人贡献的成果，并通过社区参与不断发展。您的贡献有助于就开发人员可用的工具和服务做出明智的决策。

来源： README.md9