imnotreadingal.lat

我不会读这一大段

请不要发一整面文字墙

想象一下:你在求助,却发来一篇长文,真正的问题藏在中间。

长背景有时有用,但一大段没有结构的消息通常没用。别人应该能快速扫一眼就知道你要问什么, 再决定怎么帮你,而不是先做阅读理解。

x 不要这样

今天 2:15 PM

基本上应用坏了,我昨天试了好多东西,那个登录页面好像有点问题,也可能是 API, 但文档又说了别的,我改了配置,因为部署很奇怪,然后我又觉得可能是缓存之类的...

具体问题是什么?

这样是在让读者替你寻找问题、请求和有用细节。

ok 这样更好

今天 2:15 PM

token 刷新后登录返回 401。期望结果:创建新的会话。

已试过清缓存和重装依赖。下面是路由、错误和复现步骤。

很好,把日志发来。

现在读者知道哪里坏了、应该发生什么,以及下一步该看哪里。

为什么重要

文字墙会让所有人在还不知道能不能帮忙之前就先投入精力。重点会被背景、旁枝想法和猜测埋掉。

如果你想得到有用回答,先把消息写得有用。说明问题,给出证据,把其他内容放在摘要后面。

更好的格式

问题:哪里坏了?

预期:应该发生什么?

已尝试:你已经检查了什么?

细节:日志、截图、链接或示例。

先写摘要,再放长内容。别人知道细节为什么重要时,才更愿意继续读。