DevDocs
开发者将 DevDocs.io 视为一个快速、整合、可离线使用的文档浏览器,尤其在网络不稳定或长途飞行时能显著提升生产力。他们把它与 Dash 和 Zeal 等工具比较,讨论编辑器集成和 CLI 前端,并指出由于许可顾虑而缺少 C# 文档等不足。讨论进一步延伸到开源软件中易于访问的离线文档的重要性、文档格式与生成器的取舍,以及 LLMs 等新工具如何补充甚至重塑技术知识的获取方式。
总体情绪与使用场景
- 许多评论者表示他们多年来一直依赖 DevDocs,并将其固定在工作流中或与工作流集成。
- 离线访问被强调在飞机上、Wi‑Fi 不稳定时以及无干扰环境中至关重要;有几位用户表示,使用 DevDocs 加上本地工具/LLMs 时,离线状态下反而更高效。
- 一些开发者说他们几乎离不开网络来编程(Google、MDN、ChatGPT),所以离线文档对他们来说没那么必要。
比较与替代方案
- 经常与 Dash(macOS)和 Zeal(开源、多平台)相比;DevDocs 被视为一种以网页为先的开源替代方案。
- 用户看重 Dash 能从 ReadTheDocs 和用户贡献的 docsets 中获取内容;有人指出 DevDocs 缺少这部分能力。
- 还提到其他工具:dedoc(DevDocs 的 CLI)、devdocs-desktop、Vim/Neovim/Emacs 插件、Zeal 的用户贡献 docsets、以及像 CHM、GNU info、man pages 这样的本地浏览方式。
离线文档格式与标准
- 讨论了离线文档的打包格式:压缩的静态站点、Markdown、AsciiDoc、Dash 的“docsets”、GNU info、ePub、CHM。
- 提到的权衡包括:图片与体积、按版本提供文档、JS 密集型站点更难镜像,以及浏览器对某些格式的支持逐渐减少。
- 有人希望有一种类似 RSS 的标准化方式来声明“适合离线”的文档;但没有发现被广泛采用的方案。
DevDocs 的功能、缺口与技术问题
- 其速度、跨许多 API/语言的统一搜索以及离线模式受到称赞。
- 有人希望增加更多生态:C#、Playwright、移动/操作系统 SDK、Common Lisp,以及对 Java 的困惑(以“OpenJDK”形式出现)。
- C#/.NET 文档被认为受制于许可问题,不过也有人指出微软有 CC 许可的文档和 GitHub 仓库。
- 抱怨包括:Firefox 和某些浏览器会清除离线存储;本地存储重置会清空已选文档集。
- 维护者解释说文档是从 HTML 抓取的;JS 密集和 CSS 类名随机的站点会让抓取与清理更困难;过时文档的报告按月生成。
哲学争论:离线文档、开放性与 LLMs
- 有一条很长的子讨论认为,轻松离线访问完整文档应当被视为和 FOSS 的源码可获取性同样基础。
- 其他人的回应是:
- 更大的问题是文档质量,而不只是离线访问。
- 很多用户使用直观的 UI 会比阅读文档更受益。
- LLMs 越来越能比传统文档更快地回答问题,长期来看可能会降低 DevDocs 这类工具的重要性。