跳到主要内容

如何新增一条资源

这个站点不是“教程链接仓库”，而是“资源导航 + 锐评 + 学习沉淀”的组合。

所以新增一条资源时，别先急着堆资料，先判断它值不值得进入这个站点。

第一步：先判断要不要收​

至少先回答这 5 个问题：

  • 它解决了什么问题
  • 它和站里已有资源相比，多了什么视角
  • 它最适合什么阶段的人
  • 它最可能被高估的地方在哪里
  • 如果只推荐它的一部分，我会推荐哪部分

如果这 5 个问题里有 3 个都答不上来，先别收。

第二步：按最小结构建目录​

docs/resources/<resource-name>/
  index.md
  review.md
  notes/
    index.md

最开始不用追求写满，先把这三层搭起来。

第三步：三个文件分别写什么​

index.md​

这是资源总览页，要回答：

  • 这是什么
  • 适合谁
  • 不适合谁
  • 为什么我把它收进来
  • 我建议怎么用

review.md​

这是锐评页，要回答：

  • 它最值钱的地方是什么
  • 它最容易被误读或高估的地方是什么
  • 值不值得投入时间
  • 我会怎么使用它

notes/index.md​

这是学习沉淀入口，不是目录复写页。

它应该只保留真正会往下写的内容，比如：

  • 章节级锐评
  • 专题笔记
  • 小实验
  • 阶段性复盘

第四步：写作时要克制什么​

  • 不要把原教程再复述一遍
  • 不要写一堆正确但没判断的话
  • 不要堆“我收获很多”“深入理解了”这种空话
  • 不要把 AI 生成的大段套话直接贴进来

第五步：交稿前自查​

  • 这篇内容是不是一句话就能看出你的判断
  • 有没有明确说出“适合谁 / 不适合谁”
  • 有没有指出至少一个保留意见
  • 有没有哪段只是换个说法重写原文

如果最后一条答案是“有”，删掉重写。