整整15年來(lái),MSDN與TechNet的代碼庫(kù)幾乎都沒(méi)有經(jīng)歷過(guò)任何變化。近日,微軟終于決定淘汰這兩個(gè)網(wǎng)站,新的網(wǎng)站docs.microsoft.com將取而代之,并作為開(kāi)源項(xiàng)目發(fā)布。Jeff Sandquist這樣寫(xiě)道:
簡(jiǎn)而言之,內(nèi)容是非常重要的。這些年以來(lái),我們?cè)赨serVoice平臺(tái)上對(duì)于幾百名開(kāi)發(fā)者與IT專家進(jìn)行了訪問(wèn)與問(wèn)卷調(diào)查,并對(duì)網(wǎng)站中的各種反饋信息進(jìn)行了篩選。很顯然,我們是時(shí)候做出改變,為我們的內(nèi)容創(chuàng)建一個(gè)現(xiàn)代化的web體驗(yàn)了。我們所做的第一件事是對(duì)于現(xiàn)有的內(nèi)容基礎(chǔ)平臺(tái)TechNet和MSDN進(jìn)行了一次評(píng)估,這兩個(gè)網(wǎng)站的代碼庫(kù)維持了10至15年,已經(jīng)變得相當(dāng)脆弱了。其發(fā)布與部署系統(tǒng)也相當(dāng)古老,并且原本就沒(méi)有設(shè)計(jì)為在云環(huán)境中運(yùn)行。
我們所專注的改進(jìn)不僅在于使用體驗(yàn)方面,同時(shí)也體現(xiàn)在我們所創(chuàng)建的內(nèi)容,以及用戶使用它的方式。這些年來(lái),客戶一直在催促我們不要再提供那些大塊的文本,而是以特性級(jí)別的內(nèi)容取而代之,并幫助他們實(shí)現(xiàn)解決其業(yè)務(wù)問(wèn)題的方案。我們已經(jīng)認(rèn)識(shí)到,我們所提交的內(nèi)容以及所打造的平臺(tái)必須讓客戶能夠方便地學(xué)習(xí)以及實(shí)施各種方案。
新的網(wǎng)站不僅解決了一些基本的可讀性問(wèn)題,比如列的寬度以及字體的選擇,同時(shí)還為每篇文章加入了是時(shí)間戳以及預(yù)計(jì)閱讀所需時(shí)間。時(shí)間戳的引入使MSDN與TechNet網(wǎng)站上一個(gè)持續(xù)已久的問(wèn)題得到了緩解:往往當(dāng)某人讀完一整篇文章之后,才意識(shí)到該文章只對(duì)應(yīng)某個(gè)早已過(guò)期的產(chǎn)品版本。預(yù)計(jì)閱讀時(shí)間本身并不太重要,但微軟將利用該數(shù)字對(duì)文章的長(zhǎng)度進(jìn)行一些調(diào)整,讓他們顯得不至于長(zhǎng)太。
在docs.microsoft.com上的所有文檔都已實(shí)現(xiàn)了開(kāi)源。
微軟之前曾經(jīng)提供了一個(gè)“社區(qū)補(bǔ)充”特性,但對(duì)于該特性的支持很不規(guī)范。舉例來(lái)說(shuō),面向.NET 3.5版本的ReaderWriterLockSlim類的介紹頁(yè)面中出現(xiàn)的一些留言與.NET 4.0版本中同一個(gè)類的留言就有所不同。并且在“當(dāng)前版本”頁(yè)面中完全遺漏了留言功能。
因此,微軟決定不再繼續(xù)使用這個(gè)混亂的頁(yè)面,新的頁(yè)面將加入一個(gè)“編輯”按鈕,讀者可通過(guò)該按鈕對(duì)markdown進(jìn)行編輯,并直接提交一個(gè)pull request。事實(shí)上,你甚至可以下載保存了所有文檔的整個(gè)git代碼庫(kù)。
為了提供更多非官方的變更功能,新的網(wǎng)站已經(jīng)“與Livefyre進(jìn)行合作,為所有文章留言與旁注功能。”
內(nèi)容預(yù)覽與路線圖
目前的預(yù)覽版僅涵蓋了“企業(yè)移動(dòng)文檔”。隨著時(shí)間推移,有更多的內(nèi)容將轉(zhuǎn)移至新版的網(wǎng)站上,而舊版MSDN與TechNet的頁(yè)面將會(huì)重定向至新的頁(yè)面。
查看英文原文:MSDN/TechNet Being Open Sourced as docs.microsoft.com