Session 11 - FAIR theories

We learn how to document our digital theory objects and how to make them FAIR

Overview

Topic Duration Notes
FAIR theories 45 Slides
Continue working in teams on the new formalizations 90
Teams report on progress 45

Tasks for today

  1. Update your README according to this guideline.
  2. Aim to finish steps 1-5 of the Formalization Steps
    • For Step 4 (“Collect robust phenomena”), write a short paragraph that summarizes your evaluation of the robustness of the phenomenon. (This will be needed for the final report).
  3. Start working on Step 6 (“Create your VAST display”)

Homework due next week (in groups): Work on your group project

Finalize (at least) steps 1-7 of the Formalization Steps, so that you can start working on programming in the next session.

Deliverable:

  • Increase the version (e.g., to 0.2.0) in the CITATION.cff file.
  • Push your current version to the repository.
  • Create a tag, give it the version name (e.g., v0.2.0) and write a short description for the release.

Do these steps regardless whether the theory object currently is in a “functional state” or still in a messy development version.

Homework 2

Answer the following guiding questions:

  1. Name the three immutable guiding principles of the checklist

  2. According to the introduction section of the checklist: What are the differences between a “theory” and a “formal model”?

  3. Name the two ways of evaluating a theory.

Deliverable: Submit answers to the guiding questions as a plain text or markdown file to the course’s Homework Repository, subfolder 04-Quality_checklist.