社区指南

参与 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 提供的专业支持