CMA 2024 Curriculum Specialist Instructions

Expected Updates for Curriculum and Projects:

  •  Presentation  for tutorials/project templates
  •  current technical issues by day

Current Schedule of Minor Updates

WXDX
Time frame
Status
Git branch
W2D4
Jan 15th - Jan 30th
W1D2
Jan 31th - Feb 13th
W1D4
Feb 14th - Mar 5th
W1D2
Mar 6th - Mar 13th
W1D3
Mar 14th - Mar 20th
Finalize all materials, ensure book building
Mar 21th - Mar 26th

Asana Project and Anticipated Work Schedule:

  •  https://app.asana.com/0/1205788220516381/1205788516783904 


Github Workflow:

  • Make  a fork  of our  Github Repository  under the same name as the original repository.
  • Build a virtual environment via pip and a requirements.txt file OR
  • Build conda/mamba environment from environment.yml file.
Instructions and resources can be found in  Creating the Python Environment  .
  • Create a branch for each day you work on your fork on called WXDX_curriculum_specialist_updates
  • find detailed explanations for git  here 
  • run your notebook with the standard kernel (ipykernel) not a conda related one. By starting jupyter (hub or lab) after activating your environment, you made sure that your environment is active in this kernel.
  • before saving your notebook and committing the changes to your branch, restart the kernel and clear all cells. Then you can save it,  add  the changes,  commit  them, and  push  to github (cf.  course content template )
  • Make a pull request when you have completed the material for a single day.
  • The pull request will initiate a notebook-pr action that will check the code to make sure it will create student and instructor notebooks as well as build the jupyterbook correctly. Check the Actions tab or the pull request itself if there are errors.
  • Once the Action has completed it will produce a set of colab links for instructor and student notebooks in the pull request. Please check these for accuracy. For example:
  • A code report will also be generated (see image above). It is ok if there are style issues, but if there are quality issues please address those or ask for help in the #a-24-climate-technical channel on slack.


Day/ Project Template Lead Instructions:

  •  Day Lead Instructions 
  •  New MoonCourse Specific Day Lead & Project Lead Instructions 
  •  Guide to Making Project Templates/Stubs 


Tips for refining minor update days:

  • Ensure that Day Outlines are updated:
  • We have a new template this year:  here 
  • Please make sure the notation and python packages and datasets etc are added to the correct  spreadsheets  and consistent among days.
  • There is a link in the template to the day outlines for last year - you can copy over the other information about tutorials etc from those for tutorials and make changes as needed so it aligns with your work/what is in the actual tutorials.
  • ChChi Zhang and JeJenna Pearson can help you with these as needed.
  • Update Sponsors in every Tutorial
  • Add estimated timing
  • Semantic changes, e.g. timeseries to time series in W2D3
  • see more in  🔁Change trackers 
  • Change links to OSF  for data, if they are not
  •  https://osf.io/hygbm/ 
  • Add in day-wide learning objectives to the intro.ipynb file. We are working on these day by day with the instructional design consultant. We will update them  here  and mark via Check Mark Button when they have been revised.
  • Check to make sure all images render - some files may be linked to the old  climatematchacadamy GitHub  rather than the current neuromatch organization github.
  • Update figure style file links to be from neuromatch academy GitHub under the 'Figure Settings' code block. For example the link in the screenshot below would need to be updated to  https://github.com/neuromatch/climate-course-content/blob/main/cma.mplstyle:  which should be implemented as  https://raw.githubusercontent.com/neuromatch/climate-course-content/main/cma.mplstyle 

  • Review the  tutorial template  if there are issues with exercises (commented out by KoKonstantine Tsafatinos suggesting there are errors). Please fix these.
  • Dropdown text for descriptions, additional explanation, terminology
  • For example  W2D5 Tutorial 2  Section 2.2 the 'click to see description of plot' text in read will be a dropdown in the actual notebook.Create descriptive text that supports interpretation and serves as comparison for students opinions.
  • Refine the tutorial learning objectives: do these wrap up into the day wide and course wide learning objects?
  • Consult with the instructional design consultant as needed by posting into the #a-24-climate-curriculum slack channel.
  • Review/modify the daily and pre/post course  survey questions  associated with this day
  • Are these covered by/well-related to the learning objectives?
  • Are they the important information to get from the tutorials as a whole?
  • Consult with the instructional design consultant as needed by posting into the #a-24-climate-curriculum slack channel.
  • Refine student coding exercises and discussion questions: are these interactive and engaging?
  • Consult with the instructional design consultant as needed by posting into the #a-24-climate-curriculum slack channel.
  • For example  W1D3 Tutorial 1  does not have any coding or discussions. Perhaps add a discussion question?
  • see  Types of Interactive Exercises  
  • see  Creating Accessible Materials