- #我的技术写作成长之路#
做开源项目最大的感触:写代码只占 30%,剩下 70% 都在写文档、做演示、搞推广... 你们做开源项目也是这样吗?5 赞 · 2 评论 - #我的技术写作成长之路# 问题二:清净境·你的"全透明交付"是否在制造噪音?
遇到问题的现象描述
我的每篇文章都把思考过程、推导逻辑、代码实现、优化方案全部摊开。读者反馈"很详细",但从不回头再看第二遍。我怀疑"全透明"本身成了问题——信息过载导致读者无法"入定",看完即走,没有沉淀。
问题相关代码片,运行结果,报错内容
```
// 当前写作结构(伪代码)
function writeArticle(topic) {
return {
intro: "今天讲" + topic, // 10%
problem: "很多人遇到XX问题", // 15%
analysis: "原因有12345...", // 25%
solution: "方案是ABCDE...", // 30%
code: "```js\n" + fullCode + "\n```", // 15%
conclusion: "总结:123" // 5%
};
}
// 输出:一篇"完整"但"无呼吸感"的文章
// 阅读曲线:开头高→中间断崖→结尾归零
```
报错内容:`SignalToNoiseRatioError: 信号淹没在噪声中,读者无法锁定核心`
我的初步解答思路
我试过在文章里加"重点标注""加粗""引用框",但效果有限。我怀疑需要一种"分层降噪"机制——不是把信息变少,而是让读者能选择性地深入。就像代码的"折叠/展开",或者像音乐的"主歌/副歌"。但具体怎么在文字里实现这种"可折叠的层次感"?
操作环境、软件版本等相关信息
- 当前痛点:读者无法快速定位"对我有用的部分"
- 已尝试:加粗、引用框、目录导航、代码注释
- 未尝试:信息分层结构、渐进式披露、悬念设计1 赞 · 0 评论 - #我的技术写作成长之路# 我算是发现了,稀土掘金是前端的天下,发了不少后端开发的文章,都没什么人点赞的,发了一篇前端的,两天就收获10赞
1 赞 · 12 评论
![[呲牙]](http://lf-web-assets.juejin.cn/obj/juejin-web/xitu_juejin_web/img/jj_emoji_2.cd1e2bd.png)
![[尴尬]](http://lf-web-assets.juejin.cn/obj/juejin-web/xitu_juejin_web/img/jj_emoji_11.8824107.png)