Instructional Design

[ecureuill]

Author: Maria Amelia

---

Currently proposal

Note: Dev team should only use the specifications listed in above table.
These links to documents and other notes in this issue are references used by specification team to create features specification.

ID
https://docs.google.com/presentation/d/1Grk-RJM_33PC1MyK4exe-e5KDG2-LnbqAPllca4-XKE/edit?usp=sharing

Templates
https://docs.google.com/document/d/1gEH90XkdwRTlLPY5xNJ7DqgJVvuBq8DE8Q4hSSQGeFA/edit?usp=sharing

Features specifications created

Table's label

• ✔️ spec is done and ready to be implemented
• ✅ speck is almost done, but ready to be implemented. What is missing do not -impact in the development
• to-do: Specification is not started
• ✏️ Need help
• 🔴 Failed test
• 🟢 Passed test

Prototype

issue	assignee	purpose	status	test	obs
#46	@ecureuill	AccessibilityHelp component	✔️	🔴	Existent component enhanced to be used in instructional design steps
#72	@ecureuill	redesign of menu and stepper	✔️	🔴
#73	@ecureuill	course creation workflow	✅	🔴	⚠️ need review when design, analyse and templates are finished
#74	@ecureuill	information step	✔️	🔴
#145	@ecureuill	audience step	✔️	🔴
#146	@ecureuill	Requirements step	✔️	🔴
#140	@ecureuill	course plan step	✔️	🔴
#141	@EduKobaiashi	analysis step	✔️	🔴
#142	@ecureuill	design step	✔️	🔴	fully prototyped
#143	@ecureuill	Program step	✔️	🔴	prototyped ⚠️ UPDATED
#45	@ecureuill	Report step	✔️		prototyped
#165	@ecureuill	Components	✔️		🆕
#149	@ecureuill	PDF Validation	✔️		For syllabus upload (course plan) and pdf component in Program step
	@ecureuill	Activity Component	🚫
	@flaviolima	Program step - content page	🚫
		Program step - activity page	🚫
		Program step - problem page	🚫
		Program step - forum page	🚫
#138	@ecureuill	Text Editor	✔️		for Forum component and any other editor that student need to use
#160	@ecureuill	Image	✔️		image and image gallery
#159	@ecureuill	Video	✔️		video and video gallery
#164	@ecureuill	Audio	✔️
#139	@ecureuill	Course main page	✔️
#166	@ecureuill	Course - Syllabus page	✔️
#158	@flaviolima	Course - content page	✔️
#163	@EduKobaiashi	Course - task page	✔️
		Course - problem page	🚫
		Course - forum page	🚫
		Course - topic page	🚫
		Course - PeerReview page	🚫	propose ready
		Course - Project page	🚫	propose ready
		Course Managent	🚫	propose ready
#150	@flaviolima	Help buttons	in progress		help resource for teachers
@ecureuill	Accessibility	✔️	Ready for dev team Fix currently faults Code existent requirements PDF manual accessiblity validation Authoring accessibility conditional validation Accessibility validation and status #45 SELI search courses: usability & accessibility (Search and Filtering courses and SELI contents #162 )		Need to be discussed Student profile for accessibility personalization (Student Profile: Accessibility preferences #42)

Resources

What are Spiral, Metaphor and Toy box models?

---

Current pending tasks for proposal

• No mouse over. All necessary information should be presented in the page if possible. Could use the current accessibility pattern of feedback ( see Feedbacks - Tips and Helps #46 )
• When the template models are finished
  • Define the correspondent html5 semantic structures
• Layout alternative of templates in one column
• Update list of audiences
• Remove from disabilities motor impairments and Others

** Information step **

• Instead of “Course description” should be “Brief course description”, so the user won’t mistake it with the syllabus (Course Plan). 🛑 check the current specification
• Remove syllabus pdf upload link.

**Audience **

• Target audience: update target audience options (remove options like “Mathematics”, “Computing” and “Pedagogy”).
• Better responsiveness for mobile and medium-sized screens when displaying options (avoid displaying all of them one on top of the other). (material design)[https://material.io/components/lists]
• Disabilities: User can choose which types of disabilities they want their course to be accessible to.
• Disabilities options have an “?” icon with its explanation. (Same texts that are in the Requirements page today).

Template:

• User chooses if they want to create the course freely or using a template:
• If user already has a course plan: system must display an upload link for the syllabus, which should not be displayed if user does not have a course plan.
• If user chooses to use a template, they will have to complete the “Analysis” and “Design” steps, otherwise those will be skipped.

Requirements:

• Technical (hardware, software) and Prerequisites (previous knowledge). This step is described in Issue 56: Authoring Tool - Usability enhancement #56

• Analysis:
  Information previously inputted at the Information and Audiences Pages should appear filled in. (Ex. Course title, subtitle, disabilities, etc...)

Design:

• User chooses if they want to organize their course by: Units (Spiral Model), Topics (Consistent Metaphor Model) or Problems (Toy Box Model).
• Each option has an “?” icon with an explanation of the course model.
• Insert a “Help me decide” box that suggests a course model to the user according to their answers to questions about their course.
• User, then, has to fill in the form with the Unit/Topic/Problem objective, materials, activity types...
• Map activity types options with activity types that exist in the authoring tool
• Create button to add more Units/Topics/Problems

Program:

• User fills in following the template chosen or freely with the content they want.

First Page:

• show syllabus in first page
• show audience in first page
• Change "Accessibility tool" for "This course is accessible for..."

---

Evaluation
- [ ] Activity component must have a option to evaluate it.
- [ ] Teacher panel where to manage the received activities / quiz and evaluate them

The live-demo of the steps
https://tsz10.csb.app/

[ecureuill]

If I understood, there is no conditional between course plan and instructional template, right? I.e. couse plan will always be created with same data, regardless of the chosen template.

Also, the course plan is the same as Information step of the current version of SELI, right?

If both statements are correct and if necessary, could change the name of the step 1 from Information for Course Plan

---

The template selection could be included as step and the current Program step cold be disabled until teacher select a template (or none)

---

Can I change the template when the program step is in development or finished?
For instance, I selected the Spiral template. I started to create some contents and then I realize that Toy Box fits better.

[MAmelia]

Also, the course plan is the same as Information step of the current version of SELI, right?

No. The course plan envolves two phases: analysis and design.
In the Analysis Phase we provide details on audience and learning strategies.
From the analysis and design phases the system will provide some information for the templates (Spiral, Consistent Metaphor and Toy Box), such as course title, objectives, title of each units, among others.

[MAmelia]

In the course plan, the accessibility requirements will be chosen in the analysis phase.

[ecureuill]

No. The course plan envolves two phases: analysis and design.
In the Analysis Phase we provide details on audience and learning strategies.
From the analysis and design phases the system will provide some information for the templates (Spiral, Consistent Metaphor and Toy Box), such as course title, objectives, title of each units, among others.

So, I guess that most of (or all) data of the Information step will be encompasses in Design Phase.

It's possible to create each one as steps. The Template selection step could keep disabled until all necessary information is provided in those steps.
Also, the program step will be enabled when the Template step is completed.

[MAmelia]

Can I change the template when the program step is in development or finished?
For instance, I selected the Spiral template. I started to create some contents and then I realize that Toy Box fits better.

Yes. Choices need to be flexible. The tutor can choose the Spiral Model and if he / she regrets, he / she can change. Probably, in this change he / she will lose the content information entered. The system needs to warn you of this in case of changes.
Another change that can occur: in the design phase the tutor will inform the number of units that the course will have. This information will be used by the system to establish the number of screens for the template. But the teacher can change this number of units in the form of the design phase and automatically the number of screens in the template will have to be changed. The system needs to be prepared for these changes.
It is also important for the tutor to have a preview of the pages he is creating.

[MAmelia]

No. The course plan envolves two phases: analysis and design.
In the Analysis Phase we provide details on audience and learning strategies.
From the analysis and design phases the system will provide some information for the templates (Spiral, Consistent Metaphor and Toy Box), such as course title, objectives, title of each units, among others.

So, I guess that most of (or all) data of the Information step will be encompasses in Design Phase.

It's possible to create each one as steps. The Template selection step could keep disabled until all necessary information is provided in those steps.
Also, the program step will be enabled when the Template step is completed.

I will update this comment with a live demo of the steps mechanics.

With the model, the tutor will insert the content, as in the program step. That is, the program step will be the template.

[ecureuill]

I added new steps: Analyse, Design and Template

Here is the live demo
https://tsz10.csb.app/

How to use the demo:

• Previous and Next buttons navigate through the steps
  • It simulate that a step is left incomplete by the user
• Skip button is enabled when a step is optional
• Complete button is to set a step as completed (required or optional steps)
• Publish button is only enabled when all steps is set as completed or skipped
• Conditional steps
  • Analyse must be completed to Design be enabled
  • Design must be completed to Template be enabled
  • Template must be completed to Program (Authoring Tool) be enabled

Analyse and Design steps host the instructional design forms

Template step host the template selector

[ecureuill]

Meeting 2020-04-08
@MAmelia
@rsg73626
@caroltaus
@Valfarinazzo
Flavio
Eduardo
Rebecca

---

In discussion (pending definitions)

• Analysis and Design phases is not obligatory, teacher could upload a PDF.
  • How templates will work in this scenario?
• Information step: minimum data for save a course
• Teacher's dashboard need to be implemented
• Analyse phase
• Design phase
  • Ask for type of organization (unit, topic)
  • Summary of type of adaptation need to be done, given the selected disabilities and course resources
• Content Page (Spiral)
  • Give the options in Design step, initiate with a draft (some type of contents pre-configured)
  • If teacher wants to merge units?

Notes

• Course Model isn't a layout template, it's the teaching methodology
• First Page is a summary about the course

Tasks and Required changes in OP

• Update list of audiences
  • Open a issue for development environment too
• Remove from disabilities motor impairments and Others
• Disabilities goes to Analysis step, remove from Requirement step
• Layout alternative of templates in one column
• Semantic structure for templates
• First Page
  • Add syllabus in first page
  • Add audience in first page
  • Change "Accessibility tool" for "This course is accessible for..."

[caroltaus]

Meeting 2020-04-13

@MAmelia

@Valfarinazzo

@ecureuill

@caroltaus

@EduKobaiashi

@rebeccamello

Flavio

Discussed Alterations in Course Creating

• Page 1 - Information:

  • General course information necessary to all courses (using templates or not).
  • Instead of “Course description” should be “Brief course description”, so the user won’t mistake it with the syllabus (Course Plan).
  • Remove syllabus pdf upload link.

• Page 2 - Audience:

  • Target audience: update target audience options (remove options like “Mathematics”, “Computing” and “Pedagogy”).
  • Better responsiveness for mobile and medium-sized screens when displaying options (avoid displaying all of them one on top of the other).
  • Disabilities: User can choose which types of disabilities they want their course to be accessible to.
  • Disabilities options have an “?” icon with its explanation. (Same texts that are in the Requirements page today).

• Page 3 - Template:

  • User chooses if they want to create the course freely or using a template:

  • If user already has a course plan: system must display an upload link for the syllabus, which should not be displayed if user does not have a course plan.

  • If user chooses to use a template, they will have to complete the “Analysis” and “Design” steps, otherwise those will be skipped.

• Page 4 - Requirements:

  • Technical (hardware, software) and Prerequisites (previous knowledge). This step is described in Issue 56: Authoring Tool - Usability enhancement #56

• Page 5 - Analysis:

  • Information previously inputted at the Information and Audiences Pages should appear filled in. (Ex. Course title, subtitle, disabilities, etc...)

• Page 6 - Design:

  • User chooses if they want to organize their course by: Units (Spiral Model), Topics (Consistent Metaphor Model) or Problems (Toy Box Model).

  • Each option has an “?” icon with an explanation of the course model.

  • Insert a “Help me decide” box that suggests a course model to the user according to their answers to questions about their course.

  • User, then, has to fill in the form with the Unit/Topic/Problem objective, materials, activity types...

  • Map activity types options with activity types that exist in the authoring tool

  • Create button to add more Units/Topics/Problems

Example button

• Page 7 - Program:

  • User fills in following the template chosen or freely with the content they want.

[github-actions]

This Feature Request was accepted and is ready for specfication.

[ecureuill]

Meeting 2020-05-21
@solex2006
Equator Team
Brazilian Team
Uruguay Team

Modifications

• Remove suggested softwares and hardwares from requirement step. Keep only open options
• Keep 6 suggested phrases for Broom Taxonomy and open option in Analyses step
• Can use text from external sites if its authors allowed
  • Create an issue to track this for future Credits