This repository provides you with material associated with COMP122. During the semester, the professor will be adding additional information to this repository. As such, you will need to regularly perform a git pull operation to obtain the most up-to-date information.

In addition to this repository, you will also need to clone a number of other repositories. These other repositories are primarily associated with deliverables to various assignments, projects, and exams. All of the material for COMP122 is organized within a predefined file directory ($HOME/classes/COMP122). (A directory is akin to a folder.)

This README.md file provides you with an overview of this structure and key information.

1. Finish reading this document
2. Complete the tasks in the https://github.com/COMP122/comp122-f23/blob/main/setup.md
3. Consider working on the first assignment: https://github.com/COMP122/first-assignment

• Canonical Class Directory: $HOME/classes/comp122

• Git Organization and Repositories

  • COMP122 Home: https://github.com/COMP122
  • COMP122 class material: https://github.com/COMP122/comp122-f23.git

• OS Requirements:

  MacOS: Venture 13.3 or newer
  Windows: Windows 11 or newer, with WSL installed
  Linux: Ubuntu 20.04.6 LTS
  

• Software Requirements

  • Sublime Text (editor): https://www.sublimetext.com
  • One Markdown: from the AppStore or other Markdown Viewer
    • https://apps.microsoft.com/store/detail/markdown-view/9PJ021LR0M3G
    • https://apps.apple.com/us/app/one-markdown/id1507139439
  • Slack (for class communication): https://slack.com
  • Git: preinstall or https://gitforwindows.org
  • Java JDK: https://www.oracle.com/java/technologies/downloads/

• https://en.wikipedia.org/wiki/Filesystem_Hierarchy_Standard

• Top-level documents

  • syllabus.md: The course syllabus
  • assignments.md: Living document enumerating class assignments

• General Subdirectories:

  • administrative: various files associated with the administrative process of this class
  • bin: various programs associated with COMP122
  • libexec: contains various supporting programs used by the programs in "bin"
  • reference: reference documents
  • tidbits: various nuggets of information

• Deliverables Subdirecties:

  • deliverables: directory for the placement of all deliverables)
    • 11-<name>-<account> (Section #1, Deliverable #1)
    • 24-<name>-<account> (Section #2, Deliverable #4)
    • ...
    • 40-<name>-<account> (Section #4, Deliverable #0)

• Section Subdirectories

  • models-comp-comm/

    • "lecture_ordering.md": inform regarding the order of slide presentations
    • "slide_presentations/": subdirectory
    • Lecture Notes (notes_mm_dd.md)
    • Addendum Notes per class
      (addendum_mm_dd_XX.md where XX= MM, MA, TM, TA)

  • format-encodings/

    • with the same substructure as "models_comp_comm"

  • digital-logic/

    • with the same substructure as "models_comp_comm"

  • assembly-programming/

    • with the same substructure as "models_comp_comm"