JOSE Revision

These edits are in response to reviews from JOSE submission, documented below:

Comments from @pschloss

• The License
  • As suggested, I have changed to a CC-SA license
• The Statement of Need
  • (In the paper) As suggested, I have removed the unproductive dunk on passive learning....
  • (In the paper) I have more-clearly articulated the need/niche that these materials fill: This is an active-learning data science curriculum aimed at engineering students
  • With that in mind, is is possible to change the title of the paper submission? I think that 'An Open-Source Active Learning Curriculum for Data Science in Engineering' captures the more-focused need.
• The Installation Instructions
  • I have made substantial changes to the infrastructure and installation instructions; the materials now auto-update to a user-friendly build via GitHub Action. This is reflected in the updated 'How to Use This Repo' instructions in the root readme.
• Usage
  • Related to above; the instructions now point to a single archive from the (new) build branch, which drastically simplifies the process of setting up the materials.
  • As-suggested, I have also added a .Rproj file to the repo (and build). This is no longer necessary to find the correct directory, but it does help with quality-of-life issues (to my knowledge, the Git interface for Rstudio only works when a project is open).

Comments from @firasm

• Statement of need
  • (In the paper) As suggested, I made my references to existing materials a bit more selective
  • (In the paper) Made the suggested edit(s) around the Freeman reference
  • (In the paper) Made a note about OER
• Installation Instructions
  • Made substantial improvement to these instructions: Automated a build branch through GitHub Actions to produce a user-friendly zip archive. This obviates the need for a local run of make, and automatically down-selects to just the challenges/ and exercises_sequenced/ directories.
    • These changes are reflected in the use instructions.
  • I have also built a web version of the solutions; this is a more handy and accessible version of the solutions. Also, as you suggested, this is a nice way to advertise the content!
• Usage
  • The need to run make is obviated by the updates to Installation Instructions mentioned above.
  • The confusing discrepancies between exercises/ and exercises_sequenced/ is obviated (for learners) by the updates to Installation Instructions mentioned above.
  • (In the paper) I also describe how an instructor can adapt these materials.
• Pedagogical Design
  • Added a direct link to the learning outcomes in the paper.
  • Added the suggested citation for flipped classrooms.
• Sequence
  • I believe this confusion is obviated (for learners) by the updates to Installation Instructions mentioned above.
• Overall Feedback
  • As @pschloss suggested I changed to a CC-SA license; I hope this preserves the same level of openness as the MIT license...!
  • I have also built a web version of the solutions; as you suggested, this is a nice way to advertise the content!
  • Added further description of the materials and sequence in the paper.
  • Added a description of how these materials have been used---and how one might adapt them---in the paper.
  • Added the "development story" in the paper.
  • Key models are listed in the learning outcomes document (now linked from the paper). Note that this also points to specific exercises that implement each learning outcome.
  • The learning outcomes is now linked from the paper; this provides an overview of the course content without needing to reference every individual file.

Initial release

Initial release; submitting to JOSE