docs: add non-technical guide for marking tasks complete
Simple 3-step procedure for Holly, Meg, and team members to mark their tasks complete without technical knowledge required. COVERS: Step 1: Close the issue (add comment, click close button) Step 2: Move card to Done column (drag & drop) Step 3: Update tasks.md (optional - usually done by Michael/Claude) INCLUDES: - Visual ASCII diagrams - Direct links to all pages - Common Q&A - No Git/command-line knowledge needed Created after fixing 7 completed tasks that were still open. Makes task completion accessible to non-technical team members.
This commit is contained in:
Claude
175
docs/procedures/how-to-mark-task-complete.md
Normal file
175
docs/procedures/how-to-mark-task-complete.md
Normal file
@@ -0,0 +1,175 @@
|
||||
# How to Mark a Task Complete
|
||||
|
||||
**For: Holly, Meg, or anyone on the Firefrost team**
|
||||
**Time: 2-3 minutes**
|
||||
**No technical skills needed!**
|
||||
|
||||
---
|
||||
|
||||
## The Quick 3-Step Process
|
||||
|
||||
### Step 1: Close the Issue (30 seconds)
|
||||
|
||||
1. **Go to:** https://git.firefrostgaming.com/firefrost-gaming/firefrost-operations-manual/issues
|
||||
|
||||
2. **Find your task:**
|
||||
- Scroll through the list OR
|
||||
- Use the search box at top (search for task name)
|
||||
|
||||
3. **Click on your task** to open it
|
||||
|
||||
4. **Scroll down** to the comment box at bottom
|
||||
|
||||
5. **Write a completion note:**
|
||||
```
|
||||
✅ Complete!
|
||||
|
||||
[1-2 sentences about what you did]
|
||||
|
||||
- Your Name
|
||||
```
|
||||
|
||||
6. **Click two buttons:**
|
||||
- Click green **"Comment"** button
|
||||
- Then click green **"Close"** button (it turns red when closed)
|
||||
|
||||
---
|
||||
|
||||
### Step 2: Move to Done Column (30 seconds)
|
||||
|
||||
1. **Go to:** https://git.firefrostgaming.com/firefrost-gaming
|
||||
|
||||
2. **Click "Projects"** tab at top
|
||||
|
||||
3. **Click "Firefrost Operations"**
|
||||
|
||||
4. **Find your task card** (it'll be in your colored column)
|
||||
|
||||
5. **Drag and drop:**
|
||||
- Click and hold the task card
|
||||
- Drag it to the **✅ Done** column (green, far right)
|
||||
- Let go
|
||||
|
||||
---
|
||||
|
||||
### Step 3: Update the Master List (Optional - 1 minute)
|
||||
|
||||
**Michael or Claude usually does this**, but you can too if you want:
|
||||
|
||||
1. **Go to:** https://git.firefrostgaming.com/firefrost-gaming/firefrost-operations-manual/src/branch/master/docs/core/tasks.md
|
||||
|
||||
2. **Click the pencil icon** ✏️ (top right)
|
||||
|
||||
3. **Find your task:**
|
||||
- Press `Ctrl+F` (Windows) or `Cmd+F` (Mac)
|
||||
- Search for your task name
|
||||
|
||||
4. **Add completion marker:**
|
||||
|
||||
Change this:
|
||||
```
|
||||
### 37. Staggered Server Restart System
|
||||
```
|
||||
|
||||
To this:
|
||||
```
|
||||
### 37. Staggered Server Restart System — ✅ COMPLETE
|
||||
```
|
||||
|
||||
5. **Scroll to bottom of page**
|
||||
|
||||
6. **Write commit message:**
|
||||
```
|
||||
docs: mark Task #37 complete (Staggered Server Restart)
|
||||
```
|
||||
|
||||
7. **Click green "Commit Changes"** button
|
||||
|
||||
---
|
||||
|
||||
## Visual Guide
|
||||
|
||||
```
|
||||
STEP 1: Close the Issue
|
||||
┌─────────────────────────────────────────┐
|
||||
│ Task #37: Staggered Server Restart... │
|
||||
│ │
|
||||
│ [Task details] │
|
||||
│ │
|
||||
│ ┌─────────────────────────────────────┐│
|
||||
│ │ ✅ Complete! ││
|
||||
│ │ ││
|
||||
│ │ Built the restart system... ││
|
||||
│ │ ││
|
||||
│ │ - Holly ││
|
||||
│ └─────────────────────────────────────┘│
|
||||
│ │
|
||||
│ [Comment] [Close] ← Click both │
|
||||
└─────────────────────────────────────────┘
|
||||
|
||||
STEP 2: Kanban Board
|
||||
┌────────────┬────────────┬───────────┐
|
||||
│ 🦄 Holly │ 👀 Review │ ✅ Done │
|
||||
│ │ │ │
|
||||
│ Task #37 │ │ │
|
||||
│ ────────→ │ │ │
|
||||
│ │ │ Task #37 │ ← Drag here!
|
||||
└────────────┴────────────┴───────────┘
|
||||
|
||||
STEP 3: Master List (Optional)
|
||||
┌─────────────────────────────────────────┐
|
||||
│ ### 37. Staggered Server Restart System │
|
||||
│ ↓ Add this ↓ │
|
||||
│ ### 37. Staggered Server Restart System │
|
||||
│ — ✅ COMPLETE │
|
||||
└─────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## That's It! ✅
|
||||
|
||||
**You're done!** The task is now:
|
||||
- Closed in Gitea
|
||||
- In the Done column on Kanban
|
||||
- (Optionally) Marked complete in tasks.md
|
||||
|
||||
---
|
||||
|
||||
## Common Questions
|
||||
|
||||
**Q: Do I need to do Step 3 (Master List)?**
|
||||
A: No! Michael or Claude usually does this. Steps 1 & 2 are all you need.
|
||||
|
||||
**Q: What if I can't find my task?**
|
||||
A: Search for a keyword from the task title, or ask @Michael in Discord.
|
||||
|
||||
**Q: Can I close someone else's task?**
|
||||
A: Only if you worked on it together! Otherwise let them close their own.
|
||||
|
||||
**Q: What if the task isn't fully complete?**
|
||||
A: Don't close it yet! Add a comment about your progress and leave it open.
|
||||
|
||||
**Q: I accidentally closed it, how do I reopen?**
|
||||
A: Click the "Reopen" button at bottom of the issue page.
|
||||
|
||||
---
|
||||
|
||||
## Quick Links
|
||||
|
||||
**Issues:** https://git.firefrostgaming.com/firefrost-gaming/firefrost-operations-manual/issues
|
||||
**Kanban:** https://git.firefrostgaming.com/firefrost-gaming → Projects → Firefrost Operations
|
||||
**Master List:** https://git.firefrostgaming.com/firefrost-gaming/firefrost-operations-manual/src/branch/master/docs/core/tasks.md
|
||||
|
||||
---
|
||||
|
||||
## Need Help?
|
||||
|
||||
**Ask in Discord:**
|
||||
- @Michael (The Wizard) - technical help
|
||||
- @Meg (GingerFury) - general questions
|
||||
- @Claude (The Chronicler) - documentation/process
|
||||
|
||||
---
|
||||
|
||||
**Fire + Frost + Foundation = Where Love Builds Legacy** 💙🔥❄️
|
||||
Reference in New Issue
Block a user