获取帮助

为了成功地使用 Asciidoctor 编写和发布 AsciiDoc 内容,我们鼓励您与项目维护者和其他社区成员保持对话。请随时使用下方列出的适当沟通渠道提问并讨论项目的任何方面。您的反馈通过提供用例、想法、指标和动力,帮助推动项目向前发展。

每个项目都可能提供更专注或首选的沟通渠道。请参阅相应项目的帮助部分,以查找这些详细信息。

项目聊天

平台

Zulip

URL

chat.asciidoctor.org

项目聊天是所有 Asciidoctor 用户首选的沟通方式。 这一政策有助于项目的可持续性。如果您想寻求帮助、分享反馈或与社区成员实时交流想法,请在项目聊天中进行。

聊天也是项目的论坛。与论坛一样,聊天被划分为频道。如果您发现正在进行的讨论与您感兴趣的主题相符,请随时加入。否则,请在 #users 频道发布新主题(请勿#community 频道发布!)。请勿将不相关的问题或评论发布到现有主题中,因为这会扰乱讨论并使查找答案更加困难。

在开始新主题之前,请使用筛选器或搜索功能查找现有主题。

如果您要开始一个与特定项目相关的新主题,请检查该项目是否有相应的频道,并在此频道中发布,而不是在 #users 频道。例如,如果您想询问仅适用于 AsciidoctorJ 的问题,请在 #users/asciidoctorj 频道创建该主题。

如果您不确定在哪里发布,请在 #users 频道发布,版主将根据需要重新定位该主题。 您无需采取任何行动。

项目聊天中的讨论会被存档并公开。虽然我们计划在允许的情况下尽可能长时间地保存这些日志,但无法保证它们会永久保存。

请记住,人们是自愿参与项目聊天的,因此请尊重他们的时间和兴趣。项目聊天并非一对一支持。您身处公共空间。

在写消息时,除非 a) 主题绝对需要该人的关注,或者 b) 该人已经回复了该主题并正在与您互动,否则请勿 @ 提及某人。使用 @ 提及来引起别人对您问题的注意,这对该人来说是不礼貌的,对他人也不公平。您可以自由地将您的消息发布给整个社区(无需 @ 提及)。如果有人有回应,他们会在有时间时进行分享。您可以使用 @_ 前缀引用某人而不通知他们,这被认为是可接受的行为。

问题跟踪器

如果问题不属于 Asciidoctor 核心,请在相关项目的问题跟踪器中提交该问题。例如,要提交关于 AsciidoctorJ 的问题,请使用 github.com/asciidoctor/asciidoctorj/issues 的问题跟踪器。

问题跟踪器是报告可验证的 bug、回归和安全漏洞,或提出正式、具体且明确的更改请求的首选渠道。请勿在问题跟踪器中提问如何使用软件。 问题跟踪器不是支持门户。您可以通过 项目聊天 提出关于使用方法的疑问。请勿评论已关闭的问题,除非您要添加额外的内容,例如报告修复是否有效或您如何使用它。如果您在未解决的问题中发表了非建设性的评论,例如“这个问题 X 年后状态如何?”,您的评论将被删除。

项目软件的任何重大更改或决策都会记录在问题跟踪器中。问题跟踪器也用于通过里程碑和标签规划发布。

社交媒体

平台

Twitter

URL

twitter.com/asciidoctor

如果您想分享您使用 Asciidoctor 的经验或帮助推广它,我们鼓励您在社交媒体上发帖。当您在 Twitter 上发帖关于 Asciidoctor 时,您可以提及项目的官方账号 @asciidoctor。您还可以使用 #asciidoctor 标签,以帮助他人找到您的帖子或发现其他正在谈论它的人。

讨论列表(已存档)

平台

Nabble

URL

discuss.asciidoctor.org

过去,该项目曾使用讨论列表进行一般性沟通。在此期间,社区成员通过电子邮件寻求帮助、分享反馈并与社区成员交流想法。自从成功推出 项目聊天 后,此沟通渠道已被存档且仅供阅读。您可以继续将其作为知识库使用。但是,所有新的问题、反馈、公告和其他一般性讨论都应导向项目聊天。

请体谅

请理解,社区的所有成员都是志愿者,他们提供支持是出于意愿,并且常常出于个人兴趣。在使用这些沟通渠道时,我们希望您遵守 行为准则

如果您正在寻求专业支持,您可以询问项目维护者或其他社区成员是否提供任何服务。否则,请记住参与此项目的人并不是为您工作的。