https://github.com/onichandame/den
我被项目文档维护恶心到极点了,于是返回第一性原理思考文档的本质。它是项目的长期事实记录,需要能被很快地消化吸收。
现有方法论多数是规范化文档治理方法,通过统一心智模型来加速文档的吸收速度。但并没有一个适配所有场景的标准方法论,即使是大厂也经常出现文档过时或内部有多套方法论的情况。
从输入端不好解决,输出端能否解决呢?我马上想到如果可以通过语义搜索项目文档里我需要的内容,那完全没必要死磕文档维护方法了,全部平铺在 docs/下都可以,需要查文档的时候搜索就好嘛。
den 的主要场景就是这个:快速搜索项目内文档。搞完这个心情也舒畅很多
这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。
V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。
V2EX is a community of developers, designers and creative people.