Teaching with Holarch: instructor package v1.0
==============================================

Course learning outcomes and six assignments with rubrics for a one-semester systems engineering or MBSE
course, all built on the EO-1 Open MBSE Reference Model v1.1, a fictional 6U Earth observation CubeSat.
Published by Holarch.

About the package: https://holarch.app/academic/instructor-package/
The EO-1 Reference Model v1.1: https://holarch.app/reference-models/eo-1/

License
-------
Teaching with Holarch instructor package v1.0 by Holarch (https://holarch.app/academic/instructor-package/) is
licensed under the Creative Commons Attribution 4.0 International License (CC BY 4.0):
https://creativecommons.org/licenses/by/4.0/. You may share and adapt it for any purpose, also commercially,
if you give appropriate credit ("Teaching with Holarch instructor package v1.0, Holarch, CC BY 4.0"), link to
the license and say if you made changes. The assignments use the EO-1 Reference Model, which keeps its own
credit line: "EO-1 Reference Model v1.1, Holarch, CC BY 4.0". The license covers the package files only, not
the Holarch software.

Credit line: "Teaching with Holarch instructor package v1.0, Holarch, CC BY 4.0"

Every file below is covered by this license.

Files
-----
learning-outcomes.md
  the course learning outcomes and their mapping to the assignments
assignments/A1-trace-a-need.md
  A1 Trace a need
assignments/A2-requirements-rework.md
  A2 Requirements rework and review
assignments/A3-coverage-gaps.md
  A3 Find the coverage gaps
assignments/A4-extend-the-architecture.md
  A4 Extend the architecture
assignments/A5-work-the-change.md
  A5 Work the change
assignments/A6-validation-plan.md
  A6 Validation plan
sysml-v2-teaching-boundaries.md
  Teaching SysML v2 with Holarch: what it checks and what it only keeps
LICENSE.txt
  the license notice

How to use it
-------------
1. Give each group its own copy of EO-1 v1.1. In Holarch: Manage Projects → Project Files ▾ → New Demo Project
→ CubeSat EO-1, or download eo-1-v1.1.holarch.json from https://holarch.app/reference-models/eo-1/ and import
it with Manage Projects → Project Files ▾ → Import Project…. Every assignment starts from the model as it
ships.
2. Run the course in a class organization. Add each assignment with its due date under Organization Settings →
Class Review → + New Assignment. Class Review keeps a version of every group project at each due date and
shows each student's work.
3. For A2, join each group project as a Reviewer: you can comment, approve, reject and reopen requirements,
and nothing else.
4. For A6, students start from the built-in Verification and Validation Plan template. To give them a trimmed
version with your own instructions, save one as an organization template (Write ▾ → Templates ▸ Save as
Template…, Save to: Organization) and make it the default for Test Plan Document.
5. Set the weights, group sizes and due dates for your course. The weights given are suggestions.

The assignments name Holarch pages, but every question can also be answered from the EO-1 CSV files, so
students who work in another tool can take part.

Solution notes
--------------
Solution notes with expected findings, sample answers and common mistakes for A1 to A6 are not published, so
students cannot download the answers. Instructors download them in Holarch: Organization Settings → Class
Review → Download Solution Notes. The button shows for organization administrators (instructors and teaching
assistants) of an organization with class status.

Changes
-------
v1.0: First release: the course learning outcomes and assignments A1 to A6 with rubrics, for EO-1 Reference Model v1.1.
