website icon indicating copy to clipboard operation
website copied to clipboard

Add quizzes to FWE pages

Open parlough opened this issue 1 month ago • 2 comments

The new FWE pages should have relevant quizzes added to them to support learning consolidation.

Quizzes can be added with the following format:

<Quiz title="Flutter and Dart Basics Quiz">
- question: What is the Effective Dart guideline for the first sentence of a documentation comment?
  options:
    - text: It should be a complete paragraph with at least two sentences to provide sufficient context.
      correct: false
      explanation: The guideline recommends a short summary sentence, not a full paragraph.
    - text: It must include the names of all parameters using square brackets.
      correct: false
      explanation: Parameter names can be included elsewhere, but the first sentence is a summary.
    - text: It should be a single-sentence summary, separated from the rest of the comment by a blank line.
      correct: true
      explanation: Effective Dart recommends starting with a single-sentence summary, followed by a blank line before details.
    - text: It should always begin with the name of the member being documented.
      correct: false
      explanation: Starting with the member name is not required; a concise summary is preferred.
- question: In Flutter, which widget is typically used to create a scrollable list of items?
  options:
    - text: Column
      correct: false
      explanation: A Column is not scrollable by default; use ListView for scrollable lists.
    - text: ListView
      correct: true
      explanation: ListView is the standard widget for creating scrollable lists in Flutter.
    - text: Row
      correct: false
      explanation: A Row arranges items horizontally and is not scrollable by default.
    - text: Stack
      correct: false
      explanation: Stack is used for overlapping widgets, not for scrollable lists.
</Quiz>

parlough avatar Dec 08 '25 18:12 parlough

OK, I've been down this rocky, painful road with the Java Tutorial. Static quizzes get stale SO FAST. Can we make quizzes dynamically? I am NOT a fan of the former.

sfshaza2 avatar Dec 08 '25 18:12 sfshaza2

OK, I've been down this rocky, painful road with the Java Tutorial. Static quizzes get stale SO FAST. Can we make quizzes dynamically? I am NOT a fan of the former.

This is good feedback. Shams and I talked about this in person. We should talk about it in the next infra meeting

ericwindmill avatar Dec 08 '25 18:12 ericwindmill