Skip to content

Commit acb1f54

Browse files
committed
add path instructions
1 parent c1e8b11 commit acb1f54

File tree

2 files changed

+59
-12
lines changed

2 files changed

+59
-12
lines changed
Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
---
2+
applyTo: "assignments/**/*.md"
3+
---
4+
5+
# Assignment Markdown Structure Guidelines
6+
7+
All assignment markdown files should follow these guidelines:
8+
9+
## 1. Template Usage
10+
11+
- Assignment markdown files must follow the structure in [`templates/assignment-template.md`](../../templates/assignment-template.md).
12+
- The assignment must be created as a `README.md` file
13+
- Do not remove or skip required sections from the template.
14+
15+
## 2. Section Guidance
16+
17+
The section headers should reflect the structure in the template, including the exact icon usage.
18+
19+
- **Title**: Replace `[Assignment Title]` with a short, descriptive name (e.g., `Python Basics`, `Loops and Conditionals`, `Functions and Modules`).
20+
- **Objective**: Write 1-2 sentences summarizing what the student will learn or accomplish. Focus on the main skills or concepts.
21+
- **Tasks**: For each task:
22+
- Use a specific, action-oriented task name
23+
- In the Description, clearly state what the student must do.
24+
- In Requirements, use bullet points to list the expected outcomes or features. Be specific and measurable
25+
- Provide example input/output in code blocks if helpful.
26+
27+
Do not include extra sections unless explicitly specified.
Lines changed: 32 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,39 @@
11

2-
# 🎮 Hangman Game Challenge
2+
# 📘 Assignment: Games in Python
33

4-
Build the classic word-guessing game using Python strings, loops, and user input.
4+
## 🎯 Objective
55

6-
## � What You'll Build
6+
Build the classic Hangman word-guessing game using Python strings, loops, and user input to practice fundamental programming concepts and game development logic.
77

8-
Create a Hangman game where players guess letters to reveal a hidden word before running out of attempts.
8+
## 📝 Tasks
99

10-
**Skills practiced:** String manipulation, loops, conditionals, random selection
10+
### 🛠️ Create a Hangman Game
1111

12-
## ✅ Must Have's
12+
#### Description
13+
Create a Hangman game where players guess letters to reveal a hidden word before running out of attempts. The game should provide feedback on guesses and track the player's progress.
1314

14-
Your game must:
15-
- Randomly select words from a predefined list
16-
- Accept letter guesses and show current progress (_ _ _ format)
17-
- Track incorrect guesses remaining
18-
- End when word is guessed or attempts exhausted
19-
- Display win/lose messages
15+
#### Requirements
16+
Completed program should:
17+
18+
- Randomly select words from a predefined list of at least 10 words
19+
- Display the word as underscores initially (e.g., "_ _ _ _ _")
20+
- Accept single letter guesses from the player
21+
- Show correct letters in their proper positions when guessed
22+
- Track and display incorrect guesses and remaining attempts
23+
- End the game when the word is completely guessed (win) or attempts are exhausted (lose)
24+
- Display appropriate win/lose messages with the correct word
25+
- Ask if the player wants to play again
26+
27+
### 🛠️ Add Game Enhancements
28+
29+
#### Description
30+
Enhance your basic Hangman game with additional features to make it more engaging and user-friendly.
31+
32+
#### Requirements
33+
Completed program should:
34+
35+
- Validate user input (reject numbers, symbols, and repeated guesses)
36+
- Display a visual hangman drawing that progresses with wrong guesses
37+
- Keep track of previously guessed letters
38+
- Include words of varying difficulty levels
39+
- Add a scoring system based on word length and remaining attempts

0 commit comments

Comments
 (0)