DEVTOOLBOX / 编辑方针
编辑方针
这份文档说明本站内容由谁写、依据什么写、多久复核一次,以及出现错误时如何更正。
内容范围
本站只写两类内容:工具本身的说明,以及围绕这些工具的实操指南。说明文字服务于「我现在要用这个工具完成一件事」这个场景,指南服务于「我想搞清一类问题的来龙去脉」。凡是无法落在这两类里的话题——行业新闻、产品推广、与工具无关的技术展望——都不写。
事实来源与优先级
描述工具行为时,依据的优先级从高到低是:
- 工具自身的实现代码(上限、默认值、错误分支)
- 规范文档:RFC、W3C、ISO、ECMA 等原始标准
- 平台行为:浏览器与运行时的实际表现,必要时附最小复现
- 二手资料:只用于交叉验证,不单独作为依据
更新的触发条件
内容不是写完就结束的。以下任一情况发生时,对应页面必须更新,并同步刷新页面底部的内容复核日期:工具实现变更、依赖库升级导致行为变化、相关标准修订、读者报告了可复现的错误。
如果一个工具的说明长期无法达到上述标准,我们宁愿先下线该页面,也不保留一个看起来完整但不可靠的页面。
关于自动化与 AI 的使用
我们使用自动化手段做重复劳动:批量检查页面结构、统计篇幅、比对示例输入输出是否与工具实际结果一致。草稿阶段也会借助语言模型整理初稿,但每一条技术论断都必须回到代码或标准文档核对后才允许发布,示例值必须由真实运行产生。
不采用的做法包括:把模型的输出直接当事实发布、为凑篇幅生成通用段落、在不同工具页之间复用同一段介绍。这些做法会稀释内容价值,也正是搜索引擎与广告平台判定「低价值内容」的典型特征。
更正与反馈
我们不会静默修改已发布的技术论断。涉及事实错误的更正,会在页面内容复核日期上体现;如果错误影响读者对工具输出的判断,我们会在同一天的更新里说明改了什么。
反馈渠道见联系页面。请尽量给出工具名、原始输入与你的预期结果,这样我们能用同一份输入复现问题。