This project consists of course material. The course material is one of two parts of an experimental study—the other part being a native app, and it is designed to be supplemented by the native app. The combination of both parts is dubbed an instructional app.
Alternative downloads:
Version 1.x for Feasibility Test
Version 1.x for Formal Field Test
Version 1.x for Informal Field Test
Version 1.x for Focus Groups
Version 1.x for Panel Discussion (after third meeting)
Version 1.5.2 - Summative Copy
Version 1.5.2 - Latest (Jul 9, 2020)
Open each PDF file with Acrobat Reader DC.
Download and install Pandoc and Git.
Open a terminal, and clone the project:
git clone https://gitlab.com/check-student-loans/course-material.git
(Recommended) Verify the project's authenticity: Look upward for "Verified," next to the commit SHA.
(Recommended) Open a terminal, and verify the project's integrity:
cd course-material
git show-ref --heads --hash
Check that the hash matches the commit SHA.
Open and edit "latest.md" with a text editor (e.g., Notepad, TextEdit or gedit).
Then, convert it to a Microsoft Word document.
To convert the file, open a terminal:pandoc --lua-filter gitlab-math.lua -s latest.md -o latest.docxAfterward, open "latest.docx" with Microsoft Word.
The Lua filter requires Pandoc version 2.0 or higher.
Instructors follow an introductory script and can keep an app overview for their personal reference; consult other resources for more information. The course material is distributed to students for them to complete. However, instructors should not simply hand them the material; they should illustrate some examples briefly. Students answer some questions in the course material with the native app, some not. On how to proceed from there is the instructor's discretion.
Install Pandoc, Git and R; open a terminal; then, use R to render the file as a Microsoft Word document: (R utilizes Pandoc in the background)
R
> install.packages("rmarkdown")
> library(rmarkdown)
> render("latest.md")
The benefit to rendering markdown with R is that one can embed executable R code chunks. Embed a chunk; change the file's extension to .Rmd; then, re-render the file.
Sign into GitLab, and fork the project.
Modify the course material.
Stage, commit and push the changes.
Return to GitLab, and submit a new pull request.
To report any issues, submit a new issue or discuss an existing one.
Sep 25, 2019: unified author name and email of all commits
Sep 1-2, 2019 · Version 1.5.2: merged resources from two repositories into one new repository, using BFG Repo-Cleaner purged remnants of the resources from the original repositories, archived pdf files
Aug 27, 2019 · Version 1.5.1: updated interest rate and default numbers, aligned how savings and change in savings are calculated and displayed
Aug 25, 2019 · Version 1.5: updated course material
Aug 20, 2019 · Version 1.4: reorganized resources again, corrected spreadsheet
Aug 8, 2019 · Version 1.3: reorganized resources, provided raw files for images, added README files
Jul 29-Aug 5, 2019 · Version 1.2: uploaded Ten-Year_Minimum_Errors.ipynb, updated other documents
Jul 2-6, 2019 · Version 1.1.3: split deeper_insight.docx into two documents, typeset them in LaTeX, uploaded each pdf produced from each TeX source, revised checking_calculations.xlsx, updated overview
Jul 10-11, 2018 · Version 1.1.2: updated documents
Jun 13-15, 2018 · Version 1.1.1: updated Word documents, reorganized resources, added README
Mar 27, 2018 · Version 1.1: updated Word documents
Mar 21-22, 2018 · Version 1: initial uploads
Creative Commons Attribution 4.0 International