返回博客

把一个小想法,做成可维护的项目

缩小第一版的范围,留下清晰的边界,让作品可以被持续改进。

这是一篇示例文章,用于展示内容与排版。

先完成最小的一条路径

项目开始时,可以先选定一个能够完整走通的过程。对一个内容网站来说,这条路径可能就是:写一篇文章,构建页面,再打开它的公开地址。

先完成一条路径,能更早发现真正影响使用的问题。等这条路径稳定之后,再补充新的栏目和交互。

把内容与展示分开

文章放在内容目录,项目资料放在配置文件,页面负责把它们组织起来。修改一段介绍或增加一篇文章时,尽量不需要改动布局组件。

这种划分,也让未来的改版更容易:外观可以重新设计,内容仍然保留自己的结构与地址。

给变化留一点空间

需求会变化,真正值得长期保留的是清楚的边界。一个组件只解决一个明确的问题,一份配置只描述一组稳定的信息。

{
  "title": "[项目名称]",
  "status": "进行中",
  "summary": "[项目简介]",
  "url": null
}

没有准备好的链接,可以先不显示为可点击入口;没有发生的成果,也无需为了填满页面而编造。

记录一次可以重复的发布

发布并不只是把页面放到网上,还包括确认它能正确读取样式、图片和文章地址。

  1. 在本地完成内容与页面修改。
  2. 检查类型、内容与生产构建。
  3. 在预览中打开文章深链接。
  4. 发布同一份已经验证的产物。
  5. 留下版本记录,必要时恢复上一版。

保持小,也保持完整

一个小项目也可以拥有清楚的文档和稳定的发布方式。它们会让下一次修改少一点猜测,也让这个作品更容易继续生长。

本页目录 / CONTENTS
  1. 先完成最小的一条路径
  2. 把内容与展示分开
  3. 给变化留一点空间
  4. 记录一次可以重复的发布
  5. 保持小,也保持完整
回到所有文章
02

让笔记成为可以被找到的知识

用清晰的标题、表格、代码与公式,把一份学习笔记整理成可复用的参考。

2 分钟阅读·Markdown / 知识整理