跳转到正文
工程

我们如何组织这些思考

更新于

本站文章按四个主题组织:原则、产品与设计、工程、商业。分类为读者提供起点,但不能完整解释每个决定为何重要。

让每种信息有明确的位置

每篇文章都是 src/content/notes/ 中的一个 MDX 文件。标题、日期、分类和作者与正文放在一起。分类的名称与说明集中在 src/helpers/noteCategories.ts。

例如,《简洁软件的七项原则》将分类声明为 principles。分类页、文章列表中的标签和导航中的数量,都使用同一项分类信息。

这让一条简单的规则在源码中清晰可见:文章声明自己讨论什么,共享元数据定义分类的含义。页面无需再发明另一套标签。

为初次访问的读者提供起点

我们的思考在完整列表前提供三篇精选导读,分别介绍维护责任、我们对 AI 的看法,以及这篇关于网站本身的文章。

精选条目明确记录在 src/helpers/thoughtsReading.ts。完整列表仍按发布日期排序。两者各有用途:一个介绍观点,一个帮助读者寻找具体文章。

让内容能够脱离页面布局阅读

文章也提供 Markdown 版本,新增文章进入 RSS 订阅。它们提供了不依赖网站排版的阅读方式。

英文和中文文章分别存为文本文件,可以用各自读者更自然的语言表达同一个想法。

这种结构做不到什么

分类只是粗略的引导。一个 AI 功能的决定,可能同时涉及产品设计、工程与责任,单一分类无法表达全部含义。

更重要的是,整齐的文章列表不能让缺少依据的说法变得可信。一篇有用的文章仍需要明确的问题、对取舍的解释,以及足够让别人判断的细节。这是我们希望这些文章达到的标准。



相关文章

继续探索我们的思考。