Skip to content

Instructor.md

Latest commit

 

History

History
113 lines (86 loc) · 6.5 KB

Instructor.md

File metadata and controls

113 lines (86 loc) · 6.5 KB

FarmData2 School Instructor Guide

The FarmData2 (FD2) School materials are structured to be used in a course where students are familiar with git/gitHub, have worked in a linux environment, and have some prior programming experience. However, while FD2 is written primarily in HTML, CSS, JavaScript and Vue.js prior experience with those is not required. The materials introduce enough of each technology that a student with prior programming experience can be successful.

The FD2 School activities move students through a series of introductory tutorials, hands-on activities, and homework applications. Each topic begins with students independently following an introductory tutorial outside of class that introduces them to a topic (e.g. HTML/CSS) and has them build a small artifact. Hands-on activities in the subsequent class has students expand their knowledge of the topic with several additional challenges that build upon the result of the tutorial. Finally, the a homework application following the class has them apply what they've learned to a feature in the FarmData2 project. The final result of completing the homework applications is that students will have added a basic Harvest feature to FarmData2.

The figure below illustrates visually how students progress through the introductory tutorials, hands-on activities and homework applications. Class 1 is an introductory class that introduces students to FarmData2 and the development environment and sets the stage for what they will be doing. In tutorial 1, student complete an HTML tutorial and a CSS tutorial that guide them through building a small static web page. Through hands-on activities in Class 2 they learning some new HTML elements and additional CSS Selectors and attributes and extend that web page. In homework application 2 they apply what they've learned about HTML and CSS to begin implementing the basic FarmData2 harvest feature. This pattern then repeats for each of the topics.

Diagram illustrating how students move through introductory tutorials, hands-on activities and homework applications.

Prerequisites

Students should have familiarity with:

  • Linux command line (cd, ls, cp, mkdir, etc).
  • Git and GitHub (The GitKit is one option).
  • VSCode, VSCodium or another IDE.
  • ???

Timing

  • The hands-on activities for each class are nominally targeted to take 30-45 minutes. These activities have some initial activities and then some additional challenges. This is designed to ensure everyone has something to do for the allotted time and to allow the time to be adjusted based on other classroom needs.
  • Each set of tutorials is nominally targeted to take between 1 and 2 hours outside of class.
  • Each homework assignment is nominally targeted to take between 2 and 3 hours outside of class.

Topic Outline

Below is the list of topics covered in FD2 School. Below each topic is a list of the branches that exist in the FD2-School repository and when they should be merged into development.

  1. 01-Introduction
  2. 02-HTML/CSS
    • 02-HTML-CSS-Tutorials-Soln
    • 02-HTML-CSS-Application-Starter
    • 02-HTML-CSS-Activity-Soln
  3. 03-Vue1: Vue Data Binding and List Rendering
    • 03-Vue1-Tutorials-Soln
    • 03-Vue1-Application-Starter
    • 03-Vue1-Activity-Soln
  4. 04-Vue2: Vue Inputs and User Events
    • 04-Vue2-Tutorials-Soln
    • 04-Vue2-Activity-Soln
    • 04-Vue2-Application-Starter
  5. 05-Vue3: Vue Methods and Conditional Rendering
    • 05-Vue3-Tutorials-Soln
    • 05-Vue3-Activity-Soln
    • 05-Vue3-Application-Starter
  6. 06-Vue4: Attribute Binding / Computed Properties
    • 06-Vue4-Tutorials-Soln
    • 06-Vue4-Activity-Soln
    • 06-Vue4-Application-Starter
  7. 07-FD1: Fetching Data
    • 07-FD1-Tutorials-Starter (must push with 06 so ready for T07!)
    • 07-FD1-Tutorials-Soln
    • 07-FD1-Activity-Soln
    • 07-FD1-Activity-Soln
    • 07-FD1-Application-Starter
  8. 08-FD2: Libraries and Writing Data in FarmData2
    • 08-FD2-Tutorial-Starter (must push with 07 so ready for T08!)
    • 08-FD2-Activity-Starter
    • 08-FD2-Application-Starter
  9. 09-FD3: Vue Components / FarmData2 Components
  10. 10-FD4: End-to-End Testing with Cypress
  11. 11-OSS1 - Issue writing / Bug Fix / PR Writing
  12. 12-OSS2 - Project work on Issues/Features in Kit
  13. 13-OSS3 - Issues/Features in Live FD2

Assignment Submission Logistics

  • first exposure following tutorials is individual assignment.
    • submitted by PR by the student from the team's fork to the team's upstream.
  • implementation of the feature in FD2 is a team assignment.
    • submitted by PR by someone on the team from the team's fork to the team's upstream.

Instructor ToDo

  • Form teams.
  • Create an upstream FarmData2-School repo for the course
    • Fork the FarmData2-School-Base repo
      • Set to use squash merges
    • This will be the upstream for the course
    • It will contain all starter/soln branches
    • Create a codespace on this upstream for demos.
  • Create your own fork from that upstream
    • Create a codespace on your fork to use for demos.

Process

  • everyone creates their own fork of upstream repository

  • For each assignment

    • Before assignment instructor merges starter code to upstream development
    • Students will
      • Synchronize with upstream development to get the starter code
      • Create feature branch from development
      • Complete assignment and make PR to upstream development for their feature branch.
      • After due date instructor will merge branches for solution and starter code for next assignment into the upstream development branch.

  • Feedback

    • use fetchPR to run student code
    • Do a PR review for feedback
    • Can have them respond to PR reviews for improved scores.

  • No student PRs get merged.

  • All student PRs get closed.

Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License All textual materials used in this repository are licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License

GPL V3 or Later All executable code in this repository is licensed under the GNU General Public License Version 3 or later