Web-Dev-For-Beginners/translations/zh-TW/6-space-game/3-moving-elements-around/assignment.md

# 用註解說明您的程式碼

## 指示

乾淨、良好註解的程式碼對於維護和共享您的專案是必不可少的。在這個作業中，您將練習專業開發者最重要的習慣之一：撰寫清晰、有幫助的註解，以解釋您的程式碼的目的和功能。

檢視您遊戲資料夾中目前的 `app.js` 檔案，尋找為它加入註解並整理程式碼的方法。程式碼很容易失控，現在是增加註解的好機會，以確保您的程式碼可讀，方便日後再次使用。

**您的任務包含：**
- **新增註解**說明每個主要區塊程式碼的用途
- **註解函式**並清楚描述其目的及參數
- **將程式碼分組**為具有區塊標題的邏輯區塊
- **刪除**任何未使用或多餘的程式碼
- **使用一致的**變數與函式命名慣例

## 評分規準

| 評分標準 | 優秀 | 適中 | 需改進 |
| -------- | --------- | -------- | ----------------- |
| **程式碼註解** | `app.js` 程式碼完整註解，對所有主要區塊及函式都有清楚有用的說明 | `app.js` 程式碼有適當註解，對大部分區塊有基本說明 | `app.js` 程式碼註解極少，缺乏清楚說明 |
| **程式碼組織** | 程式碼有條理地分組為具明確區塊標題的邏輯區塊，結構一致 | 程式碼稍有組織，對相關功能有基本分組 | 程式碼結構較混亂、不易理解 |
| **程式碼品質** | 所有變數和函式皆使用具描述性的命名，無未使用的程式碼，遵循一致慣例 | 大部分程式碼使用良好命名，僅少量未使用程式碼 | 變數命名不清楚，有未使用程式碼，風格不一致 |

---

<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**免責聲明**：  
本文件係使用 AI 翻譯服務 [Co-op Translator](https://github.com/Azure/co-op-translator) 進行翻譯。雖然我們力求準確，但請注意，自動翻譯可能包含錯誤或不準確之處。原始文件的母語版本應視為權威來源。對於重要資訊，建議尋求專業人工翻譯。因使用本翻譯所產生之任何誤解或誤譯，本公司概不負責。
<!-- CO-OP TRANSLATOR DISCLAIMER END -->