问HN:你上一次希望文档能在一个文件中的时候是什么时候?
对我来说,就是今天。这并不是我第一次有这样的感觉。
我坚信,大多数项目的开发文档应该集中在一个文本文件中。
每个人都可以在自己喜欢的集成开发环境(IDE)中打开它,找到或替换所需的内容。文档网站的搜索功能往往不太好用,但在我的编辑器里却没有这个问题,在你的编辑器里也一样。
复制粘贴代码片段很简单,不需要切换上下文。你可以将这个文件作为上下文传递给你喜欢的人工智能助手。无需额外的工具来收集散落在多个文件中的每一个小片段。
这太简单了,我不明白为什么这不是常态。
你怎么看呢?
查看原文
For me, it was today. Not the first time I've felt this.<p>I'm convinced dev docs for most projects should live in a single text file.<p>Everyone can open it in their preferred IDE and find or replace what they need. Search on docs websites is often broken. But not in my editor, and not in yours either.<p>Copy-pasting snippets is easy, with no context switching. You can pass the file as context to your preferred AI assistant. No need for extra tools to gather every tiny piece scattered across many files.<p>It's so simple that I don't understand why this isn't the norm.<p>What about you?