【文檔小竅門】填寫使用者回報的正确姿勢

【Why：為什麼要強調填寫使用者回報的重要性】

使用者回報是文檔團隊觸達使用者痛點的路徑之一，文檔TW可以直覺感受到使用者的文檔使用體驗，填寫的内容如果既清晰又完善，TW可短時間内精準命中問題點，快速閉環問題。

目前使用者回報填寫的内容五花八門，有些問題從回報描述上無法直覺了解到問題點在哪裡。此時，TW需要自助複現問題并思考文檔改進措施後才會落入文檔，問題閉環周期較長，且改進結果不一定能滿足使用者期望。

是以，期望您在閱讀本篇文章後，了解如何有效填寫使用者回報資訊，以便TW更好地為您服務。

【When：何時需要填寫使用者回報】

使用幫助文檔過程中，如果您遇到如下問題，可送出使用者回報：

• 低錯問題

例如：單詞拼寫錯誤、代碼拼寫錯誤、上下文對同一個内容的表述不一緻等。

• 描述與實際功能實作不符

• 已有内容不滿足實際訴求

  

• 描述不清晰或不完整無法指導操作

如下類型問題不建議您送出使用者回報，為保證閉環及時性，請使用釘釘掃描下方二維碼或填寫

釘釘群申請表單

聯系MaxCompute技術支援團隊快速定位解決：

• 腳本運作報錯

建議您先基于報錯資訊嘗試定位解決，如着實無法解決，請進釘群，專業的技術人員會及時聯系您進行處理。根據技術人員的指引提供報錯場景、報錯日志（Logview）、項目名稱、項目地域等資訊。

• 咨詢業務邏輯是否能通過MaxCompute實作

例如：是否支援.Net Core 的SDK？

• 咨詢産品功能

您可以在幫助文檔中通過關鍵字搜尋相關内容，操作指導請參見

文檔搜尋So easy

。如着實找不到想要的内容，請進釘群咨詢。

【How：如何填寫有效使用者回報】

1. 在目标幫助文檔頁，單擊右下角“文檔回報”。

   

2. 在“送出回報建議”對話框，填寫“更多建議”并截圖示意問題位置。

咨詢類問題，也可在此界面單擊“點此回報”，進入智能線上界面由機器人小智解答或進一步提工單解決。建議您直接進釘群咨詢，處理效率更高。

• 更多建議：

如果問題直覺簡單，例如低錯類，直覺描述即可。

如果問題比較複雜，例如已有内容不滿足實際需求、描述與實際功能實作不符、描述不清晰或不完整無法指導操作，您需要明确填寫問題場景（在何種情況下）、出現什麼問題、期望如何解決。

• 截圖并标記：回報問題時，點選

  

  後，單擊框選問題所在位置，還可以單擊

  

  添加文字描述，提高問題定位準确率。

  

1. 單擊“送出”。