投稿指南¶
为BeeWare. 这些指南涵盖了您进行贡献所需了解的所有内容。
我能做什么?¶
修复问题¶
您能做出的最明显的贡献就是编写代码以修复已知问题。
实施一项新功能¶
BeeWare 是否缺少您希望看到的功能?您可以 实现新功能。
编写文件¶
没有完善的文档记录,就没有完整的功能。编写文档是一种不需要编写代码的贡献方式。
处理问题¶
每次有人报告新问题时,都需要对该问题进行分流。问题分流 包括获取报告者提供的信息,并尝试重现他们所描述的问题。
查看拉取请求¶
拉取请求提交后,在合并之前需要对其进行审核。无论您对内容是否非常熟悉,您都有可能在审核拉取请求方面提供帮助。
建议一项新功能¶
您对 BeeWare 工具的新功能有建议或想法吗?您可以提出新功能,以供考虑。
翻译内容¶
BeeWare 以多种语言维护各种文档。如果您会英语以外的语言,您可以帮助我们翻译内容。
使用工具¶
您是否有使用 Toga 构建应用程序的想法?您是否有可与公文包打包的现有应用程序?您可以 使用这些工具,并提供使用体验反馈。
如何捐款?¶
设置开发环境¶
在开始为 BeeWare 做出贡献之前,您需要设置开发环境。
重现问题¶
修复问题前,您需要验证问题是否存在。重现问题也是分流的一个重要部分。
从分支机构开始工作¶
准备投稿时,请务必从分支开始工作。
避免范围蠕变¶
重要的是要保持专注,避免范围蠕变。
提出一项新功能¶
您将按照以下步骤提出新功能。
编写、运行和测试代码¶
要更新或贡献代码,您需要编写、运行和测试您的代码。
构建文档¶
要更新或贡献文档,您需要能够构建文档。
编写文件¶
要贡献文档,您需要编写新内容或更新现有内容。
添加更改说明¶
每个拉取请求都应附有变更注释。
提交拉取请求¶
修改完成后,您将提交拉取请求以供审核。
提供评论¶
如果你愿意,可以对他人的贡献进行评论。
翻译内容¶
BeeWare 使用 Weblate 进行 翻译,需要几个步骤才能开始使用。
提交新问题¶
如果您遇到新问题或错误,请提交问题。
接下来会发生什么?¶
拉取请求审查¶
提交拉取请求后,下一步就是PR 审核。
释放过程¶
合并后的贡献将进入发布流程。
风格指南¶
指南样式代码¶
以下是为BeeWare项目贡献代码的指导原则。
文件样式指南¶
以下是为BeeWare项目提供文档的指导原则。