跳到主要内容
系列文档 · 第 16 min

第 1 集 - 选一项结果

正文

选一项你一直搁置的研究结果。不要先迁移整个网站:第一次成功只需要一页私人内容,写清楚判断、证据和不确定性。

这个系列从一项范围明确的更新开始,而不是整站迁移。

这一集会完成什么

完成以后,你会得到:

  • 一项可以用一页讲清楚的结果;
  • 可供其他研究者核查的证据;
  • 一句经审阅后可以公开的陈述;
  • 一份明确不属于第一次更新的工作清单。

接下来的三集会依次创建干净的 CLI 工作区、写私人文章、完成校验,再由你明确把内容状态改为公开。本地预览需要 Docker;真正的生产网址需要你自己的部署配置。

怎样选第一项更新

选一项已经造成“你知道的事实”和“公开页面”不一致的结果:

  • 实验改变了原来的建议;
  • 论文已经录用,项目页仍然写着投稿中;
  • Benchmark、档案或版本发布改变了旧判断;
  • 项目里程碑只存在于幻灯片或聊天记录;
  • 简历表述已经有证据,却没有任何公开链接。

不要选择“我的整个研究网站”或“所有旧项目”。那是迁移项目。这个指南只负责把更新范围缩小到确实能够完成。

用普通语言写出边界

打开终端以前,先填四行:

改变了什么:
<一句话>

为什么重要:
<写给另一名研究者的一句话>

证据:
<论文、数据集、benchmark、release、档案或仓库>

还不能公开声称:
<证据不能证明什么>

例子:

改变了什么:
当前版本已经是 v1.0,但公开项目页仍然写着 0.9.0。

为什么重要:
新用户正在读错误的版本号和产品边界。

证据:
GitHub v1.0.0 Release 与当前项目内容源。

还不能公开声称:
独立打包的桌面端还不是默认上手入口。

认清四个不同动作

编辑私人内容 -> 校验 -> 公开内容 -> 预览或部署
  • 编辑改变普通 Markdown/TOML 文件;
  • 校验检查来源并重建本地索引;
  • 公开改变经过审阅的内容状态;
  • 预览或部署只在基础设施已经配置时生成公开结果。

这些动作保持分离,所以编辑或接受 Agent 提案不会意外暴露私人内容。

如果这次更新能用一页讲清楚,而且你知道证据在哪里,就可以进入第 2 集。

0 次点赞
Silan Hu40 次阅读分享:

还没有评论