Windows 機密：以色彩標示功能的眼鏡
如果你不能解釋您的功能，而無需使用行話，然後不要指望任何人都明白你的意思。
Raymond Chen
你知道你要記得寫文檔外部消費人閱讀您的文檔，因為他們不知道一切的事情之一。 當你試圖向某人解釋您的功能時，您需要停止並脫掉你的功能-有色眼鏡。
經過這麼多年，我仍然沒有任何線索 Windows 和公開的了。 在討論中有關 Windows Live ID （被稱為然後），某人的報價從題為"如何不 Windows 住 ID 參加中標識元系統和工作與 InfoCard"Web 頁的一段回答了一個問題：
"微軟正在與其他業內人士創建的現有和未來的識別提供者帶入一個連接的身份生態系統和授權最終使用者控制利用其身份身份識別元系統中。 Windows Live ID 服務將在身份識別元系統中作為參加一個身份標識提供程式之間許多能夠接受索賠從其他標識提供程式並將它們轉換以便他們可以使用微軟的線上服務內。"
這裡是什麼這一段像我聽：
"微軟正在與他人在行業內創建現有和未來的流行語帶入一個時髦詞和流行語使用者到時髦的時髦用語。 Windows Live ID 服務將參加時髦之間許多能夠時髦和時髦的一個時髦用語作為他們這樣他們就可以時髦。"
在這一點上，我停止閱讀，問任何人是不是能夠把這一段譯成英語。 沒有人可以，但很少有人私下告訴我，我想同樣的事，但不太敢說什麼。
我試圖瞭解和公開的所有毫無結果。 人寫的和公開文檔假定消費者已經熟悉和公開。 他們興致勃勃地解釋和公開管理卡，這是基於聲明的身份的單位。 換句話說：和公開管理是時髦時髦的單元的流行語。我放棄了閱讀的文檔該點。
下面是我失敗的嘗試，找出和公開的可望而不可及性質之一的另一個示例：
由和公開專案經理進行演示開始第一節的"什麼最終使用者將體驗。這是偉大的因為可以看到的是它對我意味著什麼 — 這個傢伙不知道和公開據說是或它是如何運作的。
該演示包括一個 Web 頁，說，"按一下下面的按鈕來提交卡"。
確定 — 演示已經失去了我從其最初的螢幕截圖。
"一張卡是什麼?"我不知道。 "是此問我為我的信用卡嗎？
我反正通過供電。 演示，按一下按鈕，以及一個新的對話方塊彈出。 "在這裡，你可以看到有卡可供選擇"。
它還沒告訴我什麼卡了。 卡從何而來？ 為什麼它們有用？ 他們來自和公開卡童話嗎？
不過我貼了演示。 示範選一張卡，然後在螢幕上顯示 XML 的一群。
這就是使用者體驗呢？ 點擊一個按鈕，我聽不懂，顯示一個對話方塊，充滿了神奇的豆子。 然後所選一個神奇的豆子，和一些 XML 顯示在螢幕上嗎？
我去和公開的線上說明。 我想，"這是專門為非技術型使用者編寫的文檔。 肯定這會給我解釋一下這個和公開東西整點"。
嗯，至少檔是稍好一點兒。 線上說明告訴我和公開是"系統的創建與 Web 網站和服務的關係"。
聽起來不像我想要的任何東西。 我不想與網站的關係。 我只是想訪問 CNN 和閱讀當天的頭條新聞。
在這一點上，我放棄了全部。 我意識到它是一回事，是否你上層管理不能解釋您的專案。 你自己不能解釋您自己的性質時，完全是專案的另一回事。
公平地說，和公開團隊成立了由他們的環境。 該產品是為設計和住在世界的數位識別碼。 數位識別碼世界共同財產是那裡沒人能夠描述他們做些什麼而不是訴諸的流行語。 在那裡，每個人都會談以某種方式的世界花的時間越長，越多你假設每個人都會談這種方式 — 即使它是只有的人在你小集團這樣說話。
您必須自覺認識到你在這一錯誤，並把自己的人不花了過去幾年中講您的欄位奇特行話的鞋中。 業內人士和外人之間的差距時，才可以你說你已經成功地進行通信。
.jpg)
Raymond ChenWeb 網站，舊的新事物，和具有相同標題為本書 (艾迪生-衛斯理，2007年） 處理 Windows 歷史、 Win32 程式設計與安全風險所造成的令人討厭的 MIDI 檔。