昨天下午三点四十分,我在旧笔记本里翻到一个 2019 年的书签文件夹。
名字叫「源码」。里面只有 7 个链接。
点开第五个,网页已经 404 了。域名被释放,页面只剩一行 Gorilla 的默认错误提示。我盯着那行字看了十几秒。
然后我做了件事:把剩下的 6 个链接一个个点开,记录它们的加载时间、页面结构、文档位置。其中有一个站,入口藏在一个代码块注释里。不展开文档根本看不见。
这个细节让我兴奋。真的。
大多数人写文档,会把入口放在导航栏。但那个站没有。它把入口写在 // see docs 后面,跟着一个不起眼的斜杠路径。你只有真正读代码才会撞见。
我后来在 B站免费入口网页版 那篇文章里提过一句话:好的入口不吆喝。今天我又确认了一次。
说回文档编写。我翻了三份不同站点的说明文档,作者分别是李维、周航、还有一个署名 momo。三份文档里,有两份把「快速开始」放在了第二页。第一页是更新日志。2025 年 11 月 3 日的更新日志。
这是个反常的选择。但在那个站上,它成立。
因为用户来之前已经知道要做什么,他们只想知道「昨天改了什么」。
—— 说实话,这种倒置,比一百篇使用教程都诚实。
我自己的文档习惯也被改变了。从那之后,我把每个项目的入口分成两类:荔枝fm入口免费那一类——给不想读文档的人;另一类——给愿意翻代码注释的人。两条路,互不打扰。
第三份文档我没看完。它的第一段是产品介绍,第二段是团队寄语,第三段才开始讲怎么用。我关掉了。
不是它写得差。是它写得太「完整」了。
完整有时候是一种冒犯。它默认读者有无限的时间。
所以我现在写文档,第一行永远是:入口在哪,一句话。 第二行可能也是。第三行才解释为什么。这套写法我参考过一个叫 免费高清无代码免费网站入口推荐服务 的页面,它的排版一塌糊涂,但信息密度惊人。
有点讽刺。最乱的页面给了我最干净的启发。
下午五点,我重新整理了自己的书签。7 个链接变成 4 个。删掉的那三个,两个打不开,一个要注册。
留下的其中一个,就是前面提到的那个藏在代码注释里的入口。我给它加了个星标。旁边写了一行备注:入口在注释里。
如果你也在做同样的事,B站免费入口直接进入网页高清版 那篇里有我当时的完整记录。另一篇 免费进入B站网站入口直接进入网页推荐电影 则是另一个角度的观察,讲的是入口之后的事。
两个角度,一个结论:入口不重要。入口后面的文档,才重要。