You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1.8 KiB
1.8 KiB
Comment Your Code
Instructions
Clean, well-documented code is essential for maintaining and sharing your projects. In this assignment, you'll practice one of the most important habits of professional developers: writing clear, helpful comments that explain your code's purpose and functionality.
Go over your current app.js file in your game folder, and find ways to comment it and tidy it up. It's very easy for code to get out of control, and now's a good chance to add comments to ensure that you have readable code so that you can use it later.
Your task includes:
- Add comments explaining what each major section of code does
- Document functions with clear descriptions of their purpose and parameters
- Organize code into logical blocks with section headers
- Remove any unused or redundant code
- Use consistent naming conventions for variables and functions
Rubric
| Criteria | Exemplary | Adequate | Needs Improvement |
|---|---|---|---|
| Code Documentation | app.js code is fully commented with clear, helpful explanations for all major sections and functions |
app.js code is adequately commented with basic explanations for most sections |
app.js code has minimal comments and lacks clear explanations |
| Code Organization | Code is organized into logical blocks with clear section headers and consistent structure | Code has some organization with basic grouping of related functionality | Code is somewhat disorganized and difficult to follow |
| Code Quality | All variables and functions use descriptive names, no unused code, follows consistent conventions | Most code follows good naming practices with minimal unused code | Variable names are unclear, contains unused code, inconsistent style |