作為部落格寫作夥伴提供幫助

Kubernetes 有兩個官方部落格，CNCF 也有自己的部落格，你也可以在上面釋出有關 Kubernetes 的內容。請閱讀為 Kubernetes 部落格投稿以瞭解這兩個部落格。

當人們作為作者向任一部落格投稿時，Kubernetes 專案會將作者配對為“寫作夥伴”。本頁面解釋瞭如何履行夥伴角色。

在繼續閱讀本頁面之前，您應確保至少已閱讀了文章提交的大綱。

夥伴職責

作為寫作夥伴，您將

當團隊將您與另一位作者配對時，想法是你們雙方透過審閱對方的草稿文章來互相支援。大多數閱讀 Kubernetes 部落格文章的人並非專家；內容應儘量讓該受眾容易理解，或至少適當支援非專家讀者。

部落格團隊也會在從草稿到釋出的整個過程中提供幫助。他們將直接批准您的文章釋出，或者可以安排批准流程。

您在此的主要責任是在合理的時間內溝通您的能力、可用性和進展。如果很多周過去了，您的夥伴仍未收到您的訊息，這將使整體工作耗費更長的時間。

此過程分為兩個部分

(這是推薦的選項)

部落格團隊建議文章的主要作者使用 Google Docs 或 HackMD (由他們選擇) 設定協作編輯。然後，主要作者將該文件與以下人員共享：

作為寫作夥伴，您將閱讀草稿文字，並直接提出建議或以其他方式提供反饋。部落格作者通常也同時是您的寫作夥伴，因此他們會以同樣的方式對您的部落格文章草稿提供反饋。

您的角色是推薦最少的更改，以使文章在釋出時看起來很好。如果有一個圖表確實不合邏輯，或者寫作非常不清晰：請提供反饋。如果您對措辭或標點符號有細微的意見分歧，請忽略。讓文章作者以他們自己的風格寫作，前提是他們符合部落格指南。

在此準備就緒後，首席作者將開啟一個拉取請求，並使用 Markdown 提交文章。然後，您提供一個審閱。

一些作者更喜歡從協作編輯開始；其他人則喜歡直接進入 GitHub。

無論他們選擇哪種方式，您的角色是提供反饋，讓部落格團隊能夠進行簡單的籤核並確認文章可以作為草稿合併。有關作者需要做什麼，請參閱將文章提交給 Kubernetes 部落格。

使用 GitHub 的建議功能指出任何必需的更改。

一旦 Markdown 和其他內容 (如圖片) 看起來沒問題，您就提供一個正式的審閱。

請遵循《審閱拉取請求》中有關部落格的部分。

當您認為開啟的部落格拉取請求足夠好可以合併時，在拉取請求中新增 /lgtm 命令。

這表示“我同意”(looks good to me) 的意見，並會指示倉庫自動化工具 (Prow) 繼續處理。/lgtm 命令可以讓您發表意見，無論您是否是 Kubernetes 專案的正式成員。

您或文章作者應該告知部落格團隊，有一篇文章已準備好進行籤核。根據提交指南的說明，它應該已經在 front matter 中標記為 draft: true。

對於您作為寫作夥伴，沒有第四步。一旦拉取請求可以合併，部落格團隊 (或貢獻者站點的貢獻者溝通團隊) 將接手處理。根據反饋，您可能需要返回到之前的步驟，但通常您可以期望您的夥伴工作已經完成。