Skip to content

Commit af5c1ea

Browse files
authored
Revised UserGuide
Updated the User Guide for the Thread Anonymous and Mark as Solved plugins, including features, testing instructions, and author acknowledgments.
1 parent 9a78533 commit af5c1ea

File tree

1 file changed

+147
-0
lines changed

1 file changed

+147
-0
lines changed

UserGuide.md

Lines changed: 147 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -208,6 +208,153 @@ This feature was developed with assistance from ChatGPT (OpenAI). It was used f
208208
All code and explanations were implimented, reviewed, modified, and verified by me (Moza Al Fahad).
209209

210210

211+
---
212+
213+
# Thread Anonymous Plugin – User Guide
214+
Course: 17-313 Foundations of Software Engineering (Fall 2025)
215+
Author: Raghd Al-Khalifa & Lujain Al-Mulaifi
216+
---
217+
218+
## 1. Overview
219+
220+
The Anonymous Button plugin displays an anonymous button for the user when they open up NodeBB. When clicking you toggle it on/off, it highlights green if its on/gray if off. When the feature is clicked, every post the user makes shows up as Anonymous. Hiding their name and pfp.
221+
222+
---
223+
224+
## 2. Features Implemented
225+
226+
- A button automatically appears when a user opens NodeBB.
227+
- Uses a new field with posts, that handles cases where user is anonymous.
228+
- Users can click and toggle on/off
229+
- Implemented with a plugin folder nodebb-plugin-anonymous-button with its respective JS files inside.
230+
231+
---
232+
233+
## 3. How It Works
234+
235+
1. When a user opens nodebb, there is a floating button in the corner.
236+
2. If the user clicks it, it turns on isAnonymous (highlighted green)
237+
3. If its toggled green, any post that the user makes will be masked with Anonymous.
238+
4. To toggle it off, they click the button again.
239+
240+
---
241+
242+
## 5. Automated Testing & Running Tests
243+
244+
Main test file:
245+
- Located in test/anonymous-button.test.js
246+
247+
To lint and run tests:
248+
npm run lint
249+
npm run test:anonymous-button
250+
All tests should pass.
251+
252+
---
253+
254+
## 6. Front-end Testing
255+
256+
1. Log into NodeBB with an account.
257+
2. Turn on the anon button at the bottom
258+
3. Verify that:
259+
- If Anon is green, all posts made during that is masked as Anonymous
260+
- If Anon is gray, all posts that are made show the user as it is not anonymous.
261+
262+
---
263+
264+
## 10. Author and Acknowledgement
265+
266+
Author: Raghd Al-Khalifa & Lujain Al Mulaifi
267+
Course: 17-313 Foundations of Software Engineering (Fall 2025)
268+
Institution: Carnegie Mellon University in Qatar
269+
270+
This plugin was developed at Sprint 1 and automated test suite was developed in Sprint 2, focusing on automated testing and user documentation for software features.
271+
272+
---
273+
274+
**AI Assistance Disclosure**
275+
276+
This feature was developed with assistance from ChatGPT (OpenAI). It was used for debugging, generating automated tests, and implementing the pop up feature.
277+
All code and explanations were implimented, reviewed, modified, and verified by me (Raghd Al-Khalifa & Lujain Al-Mulaifi).
278+
279+
280+
---
281+
282+
# Thread Mark as Solved Plugin – User Guide
283+
Course: 17-313 Foundations of Software Engineering (Fall 2025)
284+
Author: Raghd Al-Khalifa
285+
286+
---
287+
288+
## 1. Overview
289+
290+
The Mark as Solved plugin displays a banner and green highlight that says it was upvoted by the original owner of the post. It means that the author found the response as helpful. If it was unvoted, the banner would be removed.
291+
292+
---
293+
294+
## 2. Features Implemented
295+
296+
- A banner that automatically appears if a original post owner upvotes a reply.
297+
- Uses sockets and a brand new plugin to display it, without modifiying existing posts.
298+
- Original topic owners can upvote it to have the banner to show.
299+
- Simple and clear banner that highlights the response in a good UI design.
300+
- Implemented with a plugin folder that has a js file that handles this.
301+
302+
---
303+
304+
## 3. How It Works
305+
306+
1. When a topic owner upvotes, it shows a banner that highlights the reply saying it was found helpful/solved.
307+
2. When the topic owner removes the upvote, it goes away
308+
3. The badge stays even if the page is refreshed, and shows for everyone
309+
310+
---
311+
312+
## 5. Automated Testing & Running Tests
313+
314+
Main test file:
315+
- Located in test/solved-plugin.test.js
316+
317+
To lint and run tests:
318+
npm run lint
319+
npm run test:solved-plugin
320+
All tests should pass.
321+
322+
---
323+
324+
## 6. Front-end Testing
325+
326+
1. Log into NodeBB with a test account.
327+
2. Log into it with another
328+
3. Make a topic post
329+
4. Reply to it from another account
330+
5. Back to the main account (topic owner) upvote the reply
331+
6. Verify that:
332+
- A green badge/highlight shows over the answer saying it was marked as helpful
333+
- Refresh and ensures it stays there
334+
- If upvotes, ensure it goes away.
335+
336+
---
337+
338+
## 10. Author and Acknowledgement
339+
340+
Author: Raghd Al-Khalifa
341+
Course: 17-313 Foundations of Software Engineering (Fall 2025)
342+
Institution: Carnegie Mellon University in Qatar
343+
344+
This plugin was developed at Sprint 2 and automated test suite was developed in Sprint 2.
345+
346+
---
347+
348+
**AI Assistance Disclosure**
349+
350+
This feature was developed with assistance from ChatGPT (OpenAI). It was used for debugging, generating automated tests, and implementing the pop up feature.
351+
All code and explanations were implimented, reviewed, modified, and verified byRaghd Al-Khalifa.
352+
353+
354+
---
355+
356+
357+
211358

212359

213360

0 commit comments

Comments
 (0)