本帖最后由 MCnyan 于 2023-8-30 14:04 编辑
-编程开发版 入门介绍与指引
-.Onboarding Guide
在平时开发程序的时候,我们往往会遇到各种各样的棘手问题,这时候,你可以在编程开发版的 Mod开发问题、插件开发问题 或 其它开发问题 分类下发帖询问!
那么在发帖时都应该注意些什么呢?
.
//TODO注意:这里右面这张图是发帖目标的介绍图,因为发帖模板还没做,所以占位,正式发的时候记得删掉!!!首先要注意,发提问帖时需要 选择对应的发帖模板,并填写发帖模板中的各个项目。
此处项目对应的填写方式可见下文。.
.


在提问之前,不妨 尝试寻找一下问题的答案,确认常见的教程等内容无法解决此问题。
你可以在帖子列表上方的分类中,点击对应的教程分类,看到其它优秀的开发者编写的相关教程,或许一些比较简单基础的问题能够通过这些教程内容得以解决呢!
.
.

描述问题之前,要在 帖子标题最前方 与 模板对应项目 中,说明 API类型 和 MC版本。
此处的API类型是所提问内容对应使用到的API,例如提问插件开发问题时,API类型可以为 BukkitAPI、Spigot、Paper、Nukkit、TabooLib 等,提问Mod开发问题时,API类型可以为 Forge、Fabric 等,提问其它开发内容时,API类型可以是对应的开发平台,例如 .Net C#、Vue 3 等,如有必要,可在API类型后面添加此API的版本,例如 ProtocolLib 5.1、Vault 2.X 等,发帖模板中可用逗号分隔填写多个API类型,标题中只填写最主要的即可,以能够便于他人理解为准。
此处的MC版本是问题所涉及到的MC的版本,例如问题发生在Minecraft 1.20.1下,此处可填写1.20.1,问题如为跨版本或与版本关系不大的问题,可 标注涉及的版本范围 或 不填写。.
.

描述问题时,要在 正文 中尽力说明 问题现在的症状 与 自己期望的效果,并能够把问题症状的效果以截图等方式描述清晰,标题 应当是 正文的简要概括。
在描述时,语言应当通顺,应当易于被他人理解。
.
.

描述完毕问题后,应当在正文中 详细说明问题的复现方式,在力所能及的情况下,确保此问题 大概率能够被他人复现。
例如,可在正文后补充关键的问题代码、项目文件打包等内容,便于他人理解与测试。
.
.

正文中应当能够体现出提问者 对此问题所作出的尝试,以及这些尝试 最终的结果。
此处只需要在正文内有所体现即可,
本版块不接纳诸如“帮忙构建某代码”等直接伸手索取成果的内容,如有需要,请在对应的问答版块寻求帮助。.
.


最重要的是,提问讨论中应当态度友好,提问者应当能够接纳适度的合理批评,回答者也应当能够充分理解提问者,友好和善是一切的前提!
.

编程开发版始终致力于打造一个友好的讨论氛围,不希望被奇怪的条条框框拘束。可在 版块规定 首页中查看本版块讨论的基本原则。
最后,希望你的问题能够早日得到解决!
插图由 @MCnyan 绘制其它常见问题可参见 版块规定 和 对应的征求意见稿内容
-编程开发版 入门介绍与指引
-.Onboarding Guide

那么在发帖时都应该注意些什么呢?
.

//TODO注意:这里右面这张图是发帖目标的介绍图,因为发帖模板还没做,所以占位,正式发的时候记得删掉!!!首先要注意,发提问帖时需要 选择对应的发帖模板,并填写发帖模板中的各个项目。
此处项目对应的填写方式可见下文。.
.


在提问之前,不妨 尝试寻找一下问题的答案,确认常见的教程等内容无法解决此问题。
你可以在帖子列表上方的分类中,点击对应的教程分类,看到其它优秀的开发者编写的相关教程,或许一些比较简单基础的问题能够通过这些教程内容得以解决呢!
.
.

描述问题之前,要在 帖子标题最前方 与 模板对应项目 中,说明 API类型 和 MC版本。
此处的API类型是所提问内容对应使用到的API,例如提问插件开发问题时,API类型可以为 BukkitAPI、Spigot、Paper、Nukkit、TabooLib 等,提问Mod开发问题时,API类型可以为 Forge、Fabric 等,提问其它开发内容时,API类型可以是对应的开发平台,例如 .Net C#、Vue 3 等,如有必要,可在API类型后面添加此API的版本,例如 ProtocolLib 5.1、Vault 2.X 等,发帖模板中可用逗号分隔填写多个API类型,标题中只填写最主要的即可,以能够便于他人理解为准。
此处的MC版本是问题所涉及到的MC的版本,例如问题发生在Minecraft 1.20.1下,此处可填写1.20.1,问题如为跨版本或与版本关系不大的问题,可 标注涉及的版本范围 或 不填写。.
.

描述问题时,要在 正文 中尽力说明 问题现在的症状 与 自己期望的效果,并能够把问题症状的效果以截图等方式描述清晰,标题 应当是 正文的简要概括。
在描述时,语言应当通顺,应当易于被他人理解。
.
.

描述完毕问题后,应当在正文中 详细说明问题的复现方式,在力所能及的情况下,确保此问题 大概率能够被他人复现。
例如,可在正文后补充关键的问题代码、项目文件打包等内容,便于他人理解与测试。
.
.

正文中应当能够体现出提问者 对此问题所作出的尝试,以及这些尝试 最终的结果。
此处只需要在正文内有所体现即可,
本版块不接纳诸如“帮忙构建某代码”等直接伸手索取成果的内容,如有需要,请在对应的问答版块寻求帮助。.
.


最重要的是,提问讨论中应当态度友好,提问者应当能够接纳适度的合理批评,回答者也应当能够充分理解提问者,友好和善是一切的前提!
.

编程开发版始终致力于打造一个友好的讨论氛围,不希望被奇怪的条条框框拘束。可在 版块规定 首页中查看本版块讨论的基本原则。
最后,希望你的问题能够早日得到解决!
插图由 @MCnyan 绘制其它常见问题可参见 版块规定 和 对应的征求意见稿内容