Feature Design Doc: Article Quizzes

[WillXuCodes]

Article Quizzes

Given the wider educator use of the wiki, there's one key feature that could really help with student understanding, being article quizzes. The reason I am not implementing this myself currently is because somebody took away my admin perms on gitbook and parties contacted have been unresponsive (which is understandable given some are in the middle or end of internships). If somebody sees this who can restore them please do so!

What is an article quiz?

An article quiz is a short quiz at the bottom of a wiki article that asks questions about the topic the article is on. This can help reinforce learning and help students understand the key takeaways from each article.

A good example of this is w3, which has quizzes for each article. The specific link I have linked is for while loops and has fill in text boxes, but we should at least attempt to get multiple choice working first.

Screenshot of the site for quick reference:

Implementation Plan

Honestly, I don't exactly know the best way to do this. I'd have to poke around a little. If I had admin perms I'd look around for a plugin to do this, or attempt to use a codepen to house a quiz. It's really up in the air but I'm fairly certain this can be done in Gitbook's current form.

Reach goals for this feature.

If implemented well with a robust enough framework, we could theoretically also add certifications for each article or quiz on top of that, or create standalone quizzes (similar to the RECF ref certification) for students to strive for if their coach/teacher requires it. This can also be extended to PROS, ARMS, or any other software we develop within SIGBots as competency tests. Discussion in VTOW surrounding the need for such a certification was partially the motivation behind finally writing this doc.

Another consideration is tiered article quizzes, with a coach version and a student version tailored to each since teaching on a subject matter is definitely different than attempting to implement it yourself.

[WillXuCodes]

Current progress so far. Codepen can be found here. Help would be appreciated as I am not the best at JS/webdev.

https://codepen.io/willxucodes/pen/oNJXQgj

[WillXuCodes]

while this is effectively dead here's an even easier way of implementing it:

since gitbook allows for the embedding of google drive elements (forms, docs, etc.), we can use a google form to do a wiki quiz.

https://kb.roboticseducation.org/hc/en-us/articles/5429253866903-Judge-Advisor-Judge-Training-Certification-Course

While not hosted on gitbook, we see here that they have a google form embedded in quiz mode to simulate an in-article quiz.