社区指南

参与 SQLAlchemy 及其相关项目的指南。

虽然这些部分可能是针对 SQLAlchemy 核心项目开发者编写的，但各种指南，尤其是行为准则，适用于 SQLAlchemy 组织存储库下托管的所有项目。

获取支持

• 在请求支持之前
• Github 讨论
• 实时频道
• Tidelift 专业支持

在请求支持之前，请尝试使用可用的在线资源，在那里可以找到许多问题的答案。最重要的是 文档。在 SQLAlchemy 论坛中提出的许多问题都通过在索引页面右上角的搜索框中或任何文档页面左侧栏中进行简单的搜索来回答。文档不断改进，有时改进幅度很大。有关文档的问题可以作为错误报告（参见 报告错误）。另一种方法是搜索 Github 讨论 论坛，该论坛正在迅速成为主要的信息资源。

Github 讨论

SQLAlchemy 及其相关项目现在通过 Github 讨论 链接提供支持，该链接位于每个项目的 Github 页面上。这种类似论坛的界面允许进行类似邮件列表的讨论，但对说明代码示例和链接到问题提供了更好的支持。在讨论论坛上发帖时，我们要求发帖者尽力撰写完整且简洁的主题信息。

• 完整 - 提供重要的细节，如使用的 SQLAlchemy 版本、正在使用的数据库类型（MySQL 8、PostgreSQL 12 等）以及错误消息的完整堆栈跟踪，以及清楚的代码段，说明导致症状的确切用法。
• 简洁 - 代码和输出经过修剪和格式化，以仅说明手头的問題 - 与手头的問題无关的细节应尽可能地进行修剪，包括不相关的表和模型、对内部或第三方库的依赖关系、不相关的对象方法和关系、可以省略的大量列定义、对于外部人员难以阅读的复杂的内部变量名称。

这些只是要遵循的指南，因为我们可以并且定期会为所有技能水平的用户提供服务。只要您付出了一些努力来研究并认真地描述问题，您就获得了我们的支持！

实时频道：Gitter、IRC

有几种支持的实时选项。

SQLAlchemy 的开发者恳请所有参与这些频道的人在寻求或提供支持时尊重 行为准则。

核心开发者有时会在这些频道中出现，但请不要单独向他们寻求帮助！通常大约有 80-100 名成员同时在线 - 其中许多人可能能够帮助您解决问题。如果您的问题确实更加复杂，需要比当前 IRC 或 Gitter 上可用的技能更娴熟的帮助，那么就是时候在 Github 讨论论坛 上发帖了。

Gitter 房间

您可以使用 sqlalchemy/community Gitter 房间进行实时支持。通常会有少数 SQLAlchemy 用户和开发者在场并愿意提供帮助。

与 IRC 不同，Gitter 提供可浏览的公开历史记录 - 因此用户无需始终登录，并且可以查看他们错过的任何对话。

IRC 频道

IRC 频道是一个受欢迎的支持资源。在这个论坛中，所有技能水平的用户都可以提出简短的问题、发布代码片段，以及与其他碰巧在场的开发人员讨论技术。此处适用 IRC 礼仪的通常规则。提前付出努力了解问题的用户往往会获得更好的结果。

IRC 频道位于 Libera 网络上，频道名为 #sqlalchemy。

Tidelift 专业支持