本站文章按四个主题组织:原则、产品与设计、工程、商业。分类为读者提供起点,但不能完整解释每个决定为何重要。
让每种信息有明确的位置
每篇文章都是 src/content/notes/ 中的一个 MDX 文件。标题、日期、分类和作者与正文放在一起。分类的名称与说明集中在 src/helpers/noteCategories.ts。
例如,《简洁软件的七项原则》将分类声明为 principles。分类页、文章列表中的标签和导航中的数量,都使用同一项分类信息。
这让一条简单的规则在源码中清晰可见:文章声明自己讨论什么,共享元数据定义分类的含义。页面无需再发明另一套标签。
为初次访问的读者提供起点
我们的思考在完整列表前提供三篇精选导读,分别介绍维护责任、我们对 AI 的看法,以及这篇关于网站本身的文章。
精选条目明确记录在 src/helpers/thoughtsReading.ts。完整列表仍按发布日期排序。两者各有用途:一个介绍观点,一个帮助读者寻找具体文章。
让内容能够脱离页面布局阅读
文章也提供 Markdown 版本,新增文章进入 RSS 订阅。它们提供了不依赖网站排版的阅读方式。
英文和中文文章分别存为文本文件,可以用各自读者更自然的语言表达同一个想法。
这种结构做不到什么
分类只是粗略的引导。一个 AI 功能的决定,可能同时涉及产品设计、工程与责任,单一分类无法表达全部含义。
更重要的是,整齐的文章列表不能让缺少依据的说法变得可信。一篇有用的文章仍需要明确的问题、对取舍的解释,以及足够让别人判断的细节。这是我们希望这些文章达到的标准。
相关文章
继续探索我们的思考。