夜雨聆风学习资料网

ARTICLE · 1102020

Microsoft Learn关掉公开文档仓库,以后谁来改微软的文档?

Microsoft Learn关掉公开文档仓库,以后谁来改微软的文档?

2026年9月23日,微软在自己的社区论坛挂出一篇公告。题目直译过来是《Microsoft Learn公开文档仓库的变更》。一句话概括:微软的技术文档过去8年一直摊在GitHub上,谁看出错都能提交修改,现在这条通道要关了,年底前关完。受影响的是所有靠微软文档写代码、配服务器的人。往后你读到的每个字,都只经过微软内部的手。

微软那天到底宣布了什么?

公告说退役工作已经开始,先挑体量小的仓库动手,预计2026年12月底做完。仓库,就是GitHub上存这些文档源文件的文件夹。判断哪个仓库该退役看4条:贡献活跃度、社区参与情况、业务上的必要性、运营上的依赖。

退役不是删掉,是转成私有。外面的人看不到源文件,看不到谁在什么时候改过哪一行,也看不到别人报过什么问题、微软怎么回的。你之前复制到自己名下的那一份还在。

哪些不动?产品源码仓库和示例代码仓库不动。和开源产品、开源项目、开源社区绑在一起的文档仓库,公告说原则上保持开放。已经提了还没处理完的修改申请和问题单,走原来的流程,会给提交人发通知。反馈渠道改成Microsoft Q&A问答站、Learn页面底部的反馈按钮和社区论坛。

微软给的理由就一句:维持可信、高质量的内容,为公开仓库建立更清晰的标准。公告没解释,仓库转私有为什么更能做到这件事。

公开仓库现在还剩多少个?

这个数我自己数了一遍。GitHub上那个叫MicrosoftDocs的微软官方组织,截至9月30日挂着749个公开仓库,其中403个已经标成归档状态。归档就是只读冻结,还能看,但不再接受任何改动。真正还活着的公开文档仓库是346个。

口径说一下:只数公开可见的,已经转私有的看不见也数不到。这个数每天在掉。你去github.com/orgs/MicrosoftDocs/repositories自己筛一遍,可能和我这个差几个。

归档的时间分布比总数更说明问题。403个归档仓库里,有139个的最后改动时间落在2026年6月12日和6月15日这两天,67个加72个,两批走完。7月和8月各11个,9月15个。也就是说,这轮清理6月就在做了,9月23日那篇公告是把已经发生的事说出来。

还有几个熟悉的地址已经点不开了。memdocs是Intune和Configuration Manager那一摊运维文档,Intune是微软管手机和电脑的那套云端管理工具。windows-itpro-docs是Windows给IT管理员看的文档,defender-docs是安全产品文档。这3个都不算体量小的仓库。

社区为什么不接受“提高质量”这个说法?

9月28日,Tony Redmond在自己的博客上发了篇文章,同一天又在微软社区论坛开了个讨论帖。这个博客他写了20多年Office和Exchange。他的话不客气:有些外部提交的东西质量确实不行,但把技术社区参与和改进微软文档的这条路直接拆掉,不像是个好主意。

他最担心的是拿AI顶上。他举了Copilot写PowerShell的例子。PowerShell是微软自家的脚本语言,Copilot生成的代码经常出错,调用根本不存在的命令,参数也写错。Redmond的判断是,AI分不清网上博客里哪篇已经过时、哪篇现在还成立。而这个分辨力,恰恰是一线运维的人提交修改时带进来的东西。

另一层损失他也点了:第三方做的那些盯着文档仓库、一有改动就通知你的小工具,仓库一私有就全废。日本的Impress在9月29日也报了这条消息。

已经有人在抢着存档了?

这两天有人动手了。9月29日,一个叫nicholasswhite的开发者建了个MemDocs变更跟踪器。说明写得很老实:不是微软的仓库,不接受任何外部提交,原来那个公开的MemDocs历史保留到2026年9月2日为止。这个日期值得停一下。比公告早了3周,memdocs的公开记录就断在那里。

另一位叫merill的开发者做的Docs X-Ray走得更远。用法是把网址里的learn.microsoft.com改成learn.microsoftx.com,就能看这一页改过什么、什么时候改的。

他的说明文件里列了一张对照表。defender-docs那一行写着原仓库已经没了,改用他自建的镜像。memdocs用归档的副本读历史。entra-docs的状态是还公开就读原仓库,哪天点不开就自动切镜像。镜像每天从Microsoft Learn页面上重建好几次,把发布出来的内容按原来的目录结构再拼回去。这是趁文档还看得见,先把副本留下来。

对查文档、写代码的人意味着什么?

最直接的一条,文档里的错你以后改不了了。azure-docs这个仓库现在还公开,挂着21764个复制副本和1790个没关闭的问题单。那两万多个副本不是围观用的,是有人真把文档拷到自己名下、改完一段再提回来。

一个在生产环境踩过坑的运维,发现某个参数写反了,以前他改一行字提上去,合并之后全世界读到的就是对的。往后他只能去问答站发帖,或者点页面底部的反馈按钮。改不改、什么时候改,他不知道,你也不知道。

查不到改动记录是第二层。一个参数的默认值悄悄从A换成B,以前提交历史里看得见。转私有以后你只看到现在这一版写着B,上一版是什么不公开。运维和安全文档最吃这个,一条默认策略到底变了没变,决定你的机器今晚是什么状态。

还有一层不太被提起。遇到说不通的现象去仓库的问题区搜一圈,常能翻到几年前有人问过同样的事,下面微软工程师回了半页解释文档为什么这么写。这些对话不会搬去问答站,它们跟着仓库一起进私有。

外部贡献还有恢复的可能吗?

微软把文档搬上GitHub、允许外人直接改,是2018年2月的事。在那之前文档放在MSDN和TechNet上,你只能看。docs.microsoft.com在2016年6月上线,2022年9月并进Microsoft Learn。这条开放协作的路走了8年。

公告里说社区反馈依然重要,替代渠道是问答站、页内反馈和论坛。这3样有个共同点:你能说,但看不见谁在听,也看不见结果。以前不是这样,你改的那一行字带着你的名字进了文档,谁都能查到是谁改的。

12月底之后,微软文档好不好,只剩微软自己一家说得清。外人改不了,也看不见改了什么。这不是把质量标准提高了,是把检验标准的人请了出去。

#Microsoft Learn#微软#GitHub#开源文档#技术写作
相关阅读
Reddit认定纯HTML“不安全”:一个大站怎么把开放的门焊死1.4TB的开源:Kimi K3把权重全放了,可你跑不动

相关学习资料