文 / Google 技術文案 Jed Hartman
現在,您可以將我們的開發者文檔風格指南用於開放源代碼文檔項目:
https://developers.google.cn/style
多年以來,Google 的技術文案都在根據一份僅限內部使用的編輯風格指南編寫我們的大多數開發者文檔。為了更好地支持參與我們的開放源代碼項目(例如 Kubernetes、AMP 或 Dart)的外部貢獻者,以及提高開發者文檔間的一致性,我們現在將這份風格指南公開。
如果您向這類項目貢獻文檔,可以直接查閱這份有用的指導文檔來了解語態、語氣、用詞,以及其他風格注意事項。它對一些常規問題非常有幫助,例如提醒作者使用第二人稱、現在時、主動語態和連續逗號;也可用於查閱一些非常具體的問題,例如為了保持與 Google Developers 風格一致,應使用“app”還是“application”。
風格指南是一種參考文檔,因此,您可以根據需要查找具體信息,而不用全篇通讀。對於標點、語法和格式問題,您可以在左側導航窗格內進行頁面內搜索,查閱“Commas”(逗號)、“Lists”(列表)和“Link text”(鏈接文本)等章節。
對於具體的術語和短語,您可以查看詞表:
https://developers.google.cn/style/word-list
請密切留意版本說明頁面:
https://developers.google.cn/style/release-notes
瞭解最新動態和變動,並通過這份指南每個頁面上的 Send Feedback(發送反饋)鏈接向我們發送您的意見和建議 - 我們希望收到您的反饋,以便幫助我們不斷完善風格指南。
查看更多文章,請關注『谷歌開發者』官方微信公眾號
相關推薦
'Shopify Google Ads 轉化跟蹤設置教程'
"您可以使用 Google Ads轉化跟蹤來跟蹤人們點擊某個廣告後在您的網站上執行的操作。例如,設置 Google Ads 轉化跟蹤後,您可以查看哪個 Google Ads 廣告產生的在線商店銷量最高。如果您在 Shopify中使用Google Shopping 應用,請不...
'Google Ads 再次擴展了關鍵字變量匹配'
"在過去的幾年裡,Google Ads已經擴大了使用相近的關鍵字變量。Google改變的匹配類型不僅包括拼寫錯誤和複數,還包括功能詞、修改和重新排序。日前,谷歌再次擴展了相近變量的使用。短語匹配和廣泛匹配修飾語以下是2019年7月31日谷歌官方廣告公告原文:在未來幾周內,廣...
'Google Stadia副總:平臺將會有免費試玩和跨平臺存檔互通以及遊戲Mod'
"在最近一次Youtube頻道Stadiacast的節目中,Google Stadia的副總裁以及產品負責人John Justice確認了一些關於Stadia平臺的細節,其中有關於Stadia手柄,免費試玩以及跨平臺存檔互通等玩家喜聞樂見的特性。首先John Justice...
'深度解讀開發者們需要注意哪些?-2019蘋果秋季發佈會'
"2019年9月11號凌晨1點(北京時間),蘋果一年一度的產品發佈會如期在喬布斯劇院舉行。每年蘋果發佈會都會令各行業人員將目光聚焦於此,毫無例外,本次的蘋果發佈會也推出了令大家期待的新硬件和軟件。 本次蘋果發佈會發佈了三大硬件和兩大服務。首先,硬件包含了iPhone11系列...
'Shopify Google Shopping 廣告活動創建教程'
"您可以創建 Google Shopping宣傳活動來推廣您的產品和增加在線商店的流量。設置 Google Ads 後,您可以從Shopify 後臺的營銷部分中創建 Google 智能購物活動。如果 Shopify 的 Google Shopping 應用提供的自定義功能不...
'Google為網頁新增sponsored以及ugc兩種鏈接屬性'
"網站管理員除了可以使用鏈接屬性rel="nofollow",以指導Google搜索引擎的行為之外,Google現在還加入sponsored以及ugc兩種屬性,sponsored是專門用來標記廣告相關的鏈接,而ugc則代表屬性由使用者產生。Google在2005年推出了no...
'Shopify賣家如何設置Google Ads帳戶?獲得免費Google Ads抵扣額?'
"許多商家都使用 Google Ads,以此作為促使潛在買家查看自家Shopify產品的方式。利用 Google Ads,您可以採用搜索廣告、展示廣告、視頻廣告或應用內移動廣告的形式在 Google 網絡上展示自己的產品。在 Google 幫助中心查找有關 Google A...
'LG公開質疑三星8K電視不達標;臺積電公佈8月合併營收;IC Insights預計存儲器擴張週期終結︱新聞速遞'
"三分鐘瞭解產業大事1【LG公開質疑三星8K電視不達標】近日,在今年IFA(國際消費電子展)新聞發佈會上,韓國LG電子電視業務運營中心執行副總裁Park Hyoung-sei表示“我們認為三星的8K電視並不是真正的8K”,這是LG首次公開質疑三星。LG發出質疑的依據來自認證...
'只有1%的人知道,如何防止文檔被複制和打印?'
"在職場中最忌諱的就是機密文檔洩露,不管是在國家企事業單位還是民營企業,我們在工作中都會形成很多比較重要的文件,出於對商業機密保護的需要,我們往往需要員工可以閱讀和查看文件,但是不允許修改或者打印文件。比如像我們公司很多文件都是通過文件服務器將重要文件放到服務器上,然後共享...
'專業化AI芯片對開發者的影響'
"來源:內容來自「IEEE電氣電子工程師學會」,作者:Evan Sparks ,謝謝。這是一篇guest post。本文所表達的觀點僅僅是作者的觀點,並不代表IEEE Spectrum或IEEE。當談到人工智能的計算密集型領域時,硬件供應商正在恢復我們在摩爾定律最高峰時所享...
'怎樣將100多份Word文檔改為不同的名稱?這招你一定要會'
"怎樣將100多份Word文檔改為不同的名稱?遇到這樣的工作需要,你是用Ctrl+C和Ctrl+V操作嗎?若是,那你真的很浪費時間,與大家分享一招,只需簡單的四步就可以輕鬆搞定。第一步:複製Word文件路徑選中所有需要更改的文檔,之後點擊長按Shift鍵不放,右擊選擇複製為...
推薦中...