【发帖指南】怎么提问、怎么分享 —— 疑问帖与分享帖模板

一、为什么要发帖

  • 帮你把问题想清楚:把现象、期望、做过的尝试写下来的过程,本身就是一次梳理,很多问题写到一半就自己找到方向了
  • 帮同学:你踩的坑,下一个人大概率也会踩
  • 帮你自己:高质量的发帖会被整理进各课时的「精华汇总」,课程结束时会作为优秀学员评选的重要依据,有机会获得 Firefly 官方赠送的礼品

二、发帖之前,先做三件事

  1. 搜一下:论坛搜索 + 对应课时的答疑帖里 Ctrl+F,看是否已有人问过
  2. 自己先试一次:把"我试过什么"写下来,往往就差这一步
  3. 准备完整日志:复制文本,不要只截一张图

三、疑问帖模板(直接复制改)

标题格式

[第N课时 · 疑问] <一句话说清现象>

标题只写现象,例如:[第1课时 · 疑问] 打印 Starting kernel ... 之后串口没有任何输出

正文模板

## 环境
- 板卡 / 固件:ROC-RK3576-PC / Firefly Ubuntu 固件(版本)
- 串口工具与参数:MobaXterm / 1500000 8N1 无流控
- 相关分帖:<贴上你看过的那一节,比如 [第1课时 · 5/6 Kernel 启动参数]>

## 现象
我在第几步、敲了什么命令、看到什么。(贴关键输出)

## 我期望的
我认为这里应该发生什么。

## 我试过的
1. 试了 A → 结果
2. 试了 B → 结果

## 完整串口日志

上传日志文件

四、分享帖模板

标题格式

[第N课时 · 分享] <一句话说清你解决了什么>

例如:[第1课时 · 分享] Wait for root device 的坑:我漏了 rootwait

正文模板

## 背景
我在做什么、卡在哪里。(一两句)

## 排查过程
我是怎么一步步缩小范围的 —— 这部分的参考价值最大。

## 根因
问题的真正原因是什么。(一句话)

## 解决办法
具体命令 / 改动。贴可复制的代码块。

## 怎么验证
改完之后怎么确认真的好了。

## 给同学的提醒
一句话总结,或者"如果你也遇到,先查这里"。

分享帖最容易写到"解决办法"就结束了,但**「排查过程」才是别人最想看的**——因为同一个现象可能有三种原因,你的排查路径能帮别人快速排除两种。

五、"已解决"回复模板

问题解决后,请回到自己的帖子补一条回复,方便后来者直接看结论:

已解决。

根因:<一句话>
解决:<具体做法>
参考:<你看到的文档 / 分帖链接>

六、帖子分类

在 Course 板块下创建,可以贴上linux、zsc与rk3576等标签。

六、完整串口日志怎么贴

拷贝日志复制粘贴到txt文件并保存,然后文件上传。

七、精品帖与模糊帖对照

精品帖 模糊帖
标题 [第1课时 · 疑问] Starting kernel 之后无输出 求助,急
环境 板卡、固件版本、串口参数都写了 什么都没写,要别人追问
现象 第几步、什么命令、什么输出 “就是不行”
日志 完整文本,从复位开始 一张手机拍的屏幕照
尝试 列了 2–3 条试过的方案 无
结尾 解决后回来补了根因 解决了就消失

八、发帖礼仪

  • 帖子发到对应课时下,选对标签
  • 独立问题开新帖;同一问题的追问回在自己的帖子里
  • 不要在别人的求助帖下问不相关的问题
  • 收到帮助后顺手点个赞或回复一句
  • 别人的帖帮到你了,也可以回复"我也遇到了 + 我的情况",让信息更完整