微軟外服工作札記②——聊聊微軟的知識管理服務平臺和一些程式設計風格

thanks 發表於 2022-06-16
微軟

微軟外服工作札記②聊聊微軟的知識管理服務平臺和一些程式設計風格

前言

近期,我參加了微軟某部門的知識平臺整合工作,正好把微軟內部的各個知識管理平臺的特點做一個整理,供大家參考。

眾所周知,知識管理服務平臺其實對任何一家稍有規模的企業都是相當重要的,俗話說鐵打的營盤流水的兵,在當今社會,除了在國企,任何一個人都不太可能在一家公司工作一輩子,對公司來說也是如此,你也不能指望員工能在公司裡工作一輩子,很多時候因為業務調整、裁員等,人員變動變成了家常便飯。如何將員工在工作中積累的知識財富進行總結和沉澱,如何讓新老員工進行知識銜接、新人能夠很快地上手工作,如何避免技術骨幹將技術和業務帶走,都是每一個老闆需要經常思考的問題。

微軟在這方面也正在進行長期的試驗和探索。我在上一篇文章《聊聊微軟的大資料平臺和一些個人看法》中說過,微軟內部是一個基本上完全平等和開放的協作系統,不同的部門、員工間,雖然身處世界各地、時差不同,但是通過工作平臺有著無縫和高效的工作體驗。圍繞著大資料平臺,海量檔案的相互引用,基本上是一個網狀的去中心化的工作環境。因此,他們的知識也是極度碎片化的分配到了每一個工作小組(估計在微軟,一、二十人的工作小組達到了上萬個)。在此之前每個小組都有自己的知識管理工具和管理方式,甚至每個小組的組員都在同時使用好幾種知識管理工具,這樣造成了知識的散亂及不易整理,微軟自己也意識到了這個問題。因此,從去年起,微軟搭建了一個叫Engineering hub的知識平臺(eng.ms),並且提供了一系列的工具軟體,方便大家將各自的知識管理庫遷移到Engineering hub平臺上。

在微軟,不管什麼知識管理平臺統稱為Wiki,也就是大家所熟知的維基百科。就像百度貼吧一樣,Wiki是人人蔘與,人人貢獻力量;每個人既是知識的提供者,也是知識的消費者,這充分體現了微軟平等開放的企業氛圍;除了Microsoft Confidence的內容外,核心技術絕對不會掌握在某一兩個人手上,因此,大家在微軟,每天、每時都能夠學習到新的知識,如果沒有較強的學習能力,是很難在微軟長久地工作下去的。

大家平時使用的Wiki,有Sharepoint, Teams, OneNote, DevOps等。

SharePoint

微軟推出SharePoint已經有了20多年的歷史,曾經是最賺錢的軟體產品之一,它為企業打造了一個統一的門戶平臺和業務解決方案,將使用者、團隊和知識進行整合。進行SharePoint開發需要一定的專業知識,軟體本身也擁有相當的複雜性。在微軟內部,SharePoint也得到了最大範圍的應用,並且與其他軟體諸如Teams等進行了深度整合,使得其生命週期在不斷地延長。在SharePoint上,文件管理和其他公司的業務知識等進行整合,具有非常大的優勢。一般每個團隊在SharePoint上都有自己的門戶和團隊文件,是大家進行學習的好地方。
SharePoint作為微軟老牌的產品,其文件管理功能一直沒有進行演化,還是採取類似VS Source Safe的獨佔簽入、簽出方式,這樣一旦有人將文件簽出,忘了簽入進去,別人看到只能乾瞪眼,無法對文件進行進一步修改。相對於雲時代多人協同線上進行文件編輯,這樣的管理方式顯然是落伍了。因此,將類似於原始碼管理方式的SharePiont文件管理平臺進行遷移,也是很多團隊正在思考和在做的事情。

image

OneNote

OneNote其實是一個碎片化的知識記錄工具,類似於便籤,大家把工作中的心得可以隨時記錄下來,供大家參考,軟體本身也在標籤上使用了各種顏色予以區分。OneNote結合OneDrive,可以使得文件在各個裝置終端上使用。OneNote在記錄一些流程、技巧方面有一些優勢,但是小組內員工的個人色彩比較濃厚。經過一段時間沉澱,會發現很多當初別人記錄的內容已經過時,照著步驟去做全是坑,不如不看,小組內也不太會有人去對幾年前別人寫的心得做整理和修正,軟體本身編目的功能也比較差,系統性、完整性欠缺,所以我感覺OneNote個人作為知識記錄工具還可以,用於大的團隊就不是很適合了。

image

Teams

微軟的Teams是個非常不錯的工作協同軟體,大家可以把它想象成企業微信,主要用於聊天和視訊會議。微軟的員工遍佈於世界各地,所以選擇合適的工作協同工具是非常重要的,相信在微軟內部外部工作的同學,上班時間Teams和Outlook是得一直開著並盯著看的。Teams也應該不負眾望,很好的擔當起工作協同軟體的角色。在Teams裡,大家可以為工作小組開設Wiki,支援一些有限樣式的富文字管理。我想微軟也是在做嘗試,把Wiki同聊天軟體捆綁在一起。可惜的是,Teams的Wiki不支援多級目錄的管理,只能記錄一些少部分的內容,並且僅限於小組內部的成員觀看和編輯,這樣就沒法把知識分享出去;如果需要讓別人能訪問到自己的Wiki,還需要管理員進行授權,加到討論組裡面去,所以他的功能就相對比較封閉了;從遷移的情況來看,Teams裡面的Wiki是被遷移得最多的,知識相當地分散和零碎,應該說不是個很好的知識管理系統,用於記錄小組內的備忘還不錯。

image

DevOps裡面的Wiki

應該說DevOps的初衷不是用來做知識管理,他對於敏捷開發的支援、CI/CD整合方面非常完美,也是國內很多開發團隊首選的原始碼管理工具。我們在初始化程式碼庫的時候,可以使用它的Wiki功能,這樣就預設生成了以Markdown(.md)格式的Wiki程式碼庫;在文字中使用markdown標籤,多人提交PR對Wiki進行管理。DevOps裡的Wiki功能已經比較全了,Markdown本身對Wiki的支援就很好,它支援多級目錄、目錄搜尋和全文檢索,可以檢視各個版本,還可發表評論、標識等;並且可以開放給其他組裡的同事看,不需要額外的許可權授予。所以微軟的一些大資料平臺包括Cosmos在內就使用DevOps中包含的Wiki功能;微軟在做最後的EngHub整合的時候,也借鑑了DevOps的部分管理功能。

image

EngHub(eng.ms)

最後請出的是我們的王牌知識管理工具EngHub了,EngHub借鑑了GitHub的思想,是一個工程師(engineer)或者工程(engineering)的平臺。微軟為此申請了獨立的專有域名,有專門的工作小組對其開發和維護。在這個平臺上幾乎整合了微軟所有的業務條線的知識內容,有著海量的目錄\分類和內容,對於在微軟正在工作\工作過的員工,或多或少都會在EngHub上留下痕跡。

面對一個如此龐雜的的知識服務平臺,僅依靠一兩個團隊是很難將他維護好的。因此,每個團隊要將自己的知識貢獻出來之前,就要先聯絡EngHub團隊,申請相應的目錄和金鑰;在記錄下程式碼庫地址後,EngHub會以輪詢的方式通過版本管理從你的程式碼庫讀入文件並轉換、整合到Enghub裡;他在很大程度上利用了現有的DevOps資源,將內容管理分散到每個具體的團隊,又能夠進行高度的統一和整合,其統籌的思路很值得我們的管理者進行借鑑。

EngHub背後的文件解析使用的是Docfx引擎(https://github.com/dotnet/docfx),微軟使用的還是內部的一個專用的分支版本,目前穩定版本是2.x; 3.x都是Beta版本,和2.x有些相容性差別,不太建議使用。EngHub網站前端使用的展現引擎竟然是nodejs技術棧的react?!,具有一些無重新整理SPA的體驗,希望有一天能用上Blazor 。
我當時為了把團隊各方面零散的重要的知識整合到EngHub裡,前前後後零零散散忙了半年,遷移了數萬篇文件,幾個G的內容,這些內容在EngHub上的目錄結構裡僅僅是一個很裡層的很小的一個連結。因此可嘆EngHub規模的龐大,有時間的話逛逛EngHub也是很有趣味的,前提是你要對計算機有興趣,並且英文還算過得去。

image

微軟內部的一些程式碼程式設計風格

“一直在模仿,從未被超越”對於微軟來說是最恰當不過的。在技術上從來不進行頭部創新,而是採取跟隨者的策略,自己的企業反而在市場上始終處於領先位置,是商戰裡常用的一種策略,國內的企業我就不舉例了。拿微軟說,它的Windows圖形介面抄襲MacOS,IE瀏覽器抄襲Netscape,後來IE、Edge紛紛被Chrome超越,又反過來用Chrome的引擎做Edge。微軟內部的大資料引擎Cosmos應該是Hadoop的一個發行版本修改而來的,至今也沒有開源,它執行在windows平臺上,增加了對.net的支援,定製了一些功能,加強了穩定性。在Cosmos上可以使用Java、Scala、Python等語言進行開發,也可以執行Spark、YARN等作業,這不就是Hadoop套個殼麼.......

在微軟,使用各種語言開發的人很多,程式碼中使用設計模式的很少,倒是使用模板語言、DSL的比較多,比如Cosmos上執行SCOPE、為ObjectStore做定義的Bond等,都是一些模板語言+語法糖。

使用大資料平臺,少不得在各個系統間相互呼叫,一般用的都是Azure Function、WebHook、WebAPI等。Http本身就不是可靠的的通訊協議,所以在相互呼叫中,會經常出現404、500錯誤,一般要設立重試機制。從.net core開始,微軟就不再提供WCF,舊專案遷移到.net core\5\6需要第三方WCF庫,協議和功能方面有著很多限制;我發現微軟對SOA的熱度正在冷淡,重心逐漸向微服務、容器化、SAAS、PASSS、低程式碼平臺上轉移。因為如果使用WCF、WS等SOA等技術,大資料平臺及和周邊的應用之間的通訊質量還是可以得到保證的。在微軟,我還沒碰到比較好的架構師,只是大家對如何協同工作以及程式健壯、穩定性方面有著一定的共識,程式碼寫得特別爛的人也進不了微軟周邊;微軟地很多產品我想都是對開源產品的模仿,也就是我們俗稱的重複造輪子,然後在上面構建自己的業務系統。

微軟外服工作札記系列
聊聊我在微軟外服大資料分析部門的工作經歷及一些個人見解
②聊聊微軟的知識管理服務平臺和一些程式設計風格
③視窗函式的介紹