Authoring Tool - Activity component enhancement

[ecureuill]

:warning: Wire-frames and live-demos are just for example purpose. They don't meet entirely this requirement.

:pencil2: Pencil icon marks specs that are waiting for definition

---

This requirement is about enhancement of Activity Component.

Index

1. Currently Version
2. Enhancement
   1. Features
   2. Usability
   3. Validations
   4. Error Prevention
   5. Feedback
      1. Labels
      2. Instructions
      3. Help button
      4. Guided Help button
      5. Error Identification
3. Wire frames

---

Currently Version

Activity form: Storytelling

Help Button

Activity form: Upload

Help Button

Activity form: Text

Help Button

Activity form: Forum

Help Button

Enhancement

• An activity could be setting to be graded, part of project, peer reviewed and in group.
• Activity checked as Graded will be listed in page Course Managment to be assessed by teacher
• Activities checked as Project will be listed in page Course's project. Course's project grade will be composed by each activity.
• Activities checked as peer reviewed will be enabled to be assessed by others students.
• Activities can set to be be done in group.

User inputs

• instructions component text editor (#138 )
• project component checkbox
• graded component checkbox
• peerReviewed component checkbox
• group component input type number
• groupAssign component input select
  • options
    • bySystem
    • byTeacher
    • byStudent

Features

If project==true

• [ ] graded is disabled
• [ ] graded default value is true

if group==0

• [ ] groupAssign visible=false

if group>0

• [ ] groupAssign visible=true

Usability

• [ ] meet #50
• [ ] Single-column layout
• [ ] Match fields to the type and size of the input.
• [ ] Replace * for "'(required)". It could be achieved by css.
  • [ ] Alternatively, include a statement in the beginning of the page that "*" is used for required fields

Validations

:pencil2:

Error Prevention

N/A

Feedback

• [ ] #46 Use the AccessibilityHelp component
  • inline instructions
  • help
  • error messages

Labels

If the used component do not have a native visible label, use aria-label or `aria-

:pencil2: field	visible label	aria-label or aria-labelledby
project	Course`s project
graded	Graded activity
peerReviwed	Peer reviewed
group	Group activity (number of participants)
group	How should the participants be assigned to the group?
bySystem	by System
byTeacher	by Teacher
byStudent	by Student

Instructions

• inline instructions is the tip in AccessibilityHelp component. In other words, the brief instruction right above the input field.
• Placeholder is a example inside the input field
• Tooltip is a popup that shows on focus and hover.
  • It will host the Label of the component, when the component doesn't have a visible label.
  • It will host the brief description of the required input, when the component doesn't have a inline description

:pencil2:	field	Inline Instruction	Tooltip
project	If this activity is part of course's project, student will be notified about that and the activity grade will compose the project grade.
graded	Activities should be graded or not graded. If you choose this option, you will have the option to assess the answers.
peerReviwed	If this options is selected, students answers should be assessed by other students.
group	If you enter a number grater then 0, this activity should be solved in group.
group	The group assignment could be automatic (by System option), performed by you (by teacher option) or by students.

Help button ("More details")

N/A

Guided Help button (“help me decide”)

N/A

Error Identification and Suggestion

field	Validation	Error message
all	Required	[Field_Name] is required. Please complete it

Wire-Frames

Type of Activity

Activity in group

Group Assignment option

[github-actions[bot]]

This Feature Request was accepted, but are not going to be implemented in next release.