Merge remote-tracking branch 'origin/main' into self-account-creation

Author: Barb Cutler

Gemfile

@@ -7,7 +7,7 @@ end
 
 gem 'wdm', '>= 0.1.1' if Gem.win_platform?
 
-gem "webrick", "~> 1.8"
+gem "webrick", "~> 1.9"
 
 gem 'html-proofer', "~> 3.19.4"
 

Gemfile.lock

@@ -40,6 +40,7 @@ GEM
     faraday-net_http (3.1.1)
       net-http
     ffi (1.17.0-arm64-darwin)
+    ffi (1.17.0-x64-mingw-ucrt)
     ffi (1.17.0-x86_64-linux-gnu)
     forwardable-extended (2.6.0)
     gemoji (4.1.0)
@@ -219,7 +220,7 @@ GEM
       gemoji (>= 3, < 5)
       html-pipeline (~> 2.2)
       jekyll (>= 3.0, < 5.0)
-    json (2.7.2)
+    json (2.13.0)
     kramdown (2.4.0)
       rexml
     kramdown-parser-gfm (1.1.0)
@@ -240,6 +241,8 @@ GEM
       uri
     nokogiri (1.16.7-arm64-darwin)
       racc (~> 1.4)
+    nokogiri (1.16.7-x64-mingw-ucrt)
+      racc (~> 1.4)
     nokogiri (1.16.7-x86_64-linux)
       racc (~> 1.4)
     octokit (4.25.1)
@@ -277,19 +280,22 @@ GEM
       concurrent-ruby (~> 1.0)
     unicode-display_width (1.8.0)
     uri (0.13.0)
-    webrick (1.8.1)
+    wdm (0.2.0)
+    webrick (1.9.1)
     yell (2.2.2)
 
 PLATFORMS
   arm64-darwin-22
   arm64-darwin-23
+  x64-mingw-ucrt
   x86_64-linux
 
 DEPENDENCIES
   github-pages (= 232)
   html-proofer (~> 3.19.4)
   json
-  webrick (~> 1.8)
+  wdm (>= 0.1.1)
+  webrick (~> 1.9)
 
 BUNDLED WITH
    2.5.6

_docs/developer/development_instructions/automated_grading.md

@@ -118,12 +118,14 @@ number:
 
 ---
 
-## Debugging 
+## Debugging
 
 To debug new features for autograding, it can be helpful to run
 `submitty_autograding_shipper.py` and `submitty_autograding_worker.py`
 interactively and inspect the output.
 
+_NOTE: A cron job runs hourly to detect autograding shipper outages on the primary machine. To avoid interference during debugging, this job should be disabled before proceeding. See [Capture Cron Error Messages](/sysadmin/installation/system_customization#capture-cron-error-messages) for instructions on disabling the script._
+
 To do this:
 
 1. Stop the daemons (on each server, as appropriate)

_docs/developer/development_instructions/index.md

@@ -250,6 +250,15 @@ these changes.
   missing the hundreds of sample student submissions present in the
   full installation.
 
+  You can append the `--test_only_grading` flag to the above command to
+  more closely mimic the version that is on the Cypress CI.
+
+  If you only need a certain courses, you can append each course name to
+  the above command to only create the courses you want.
+
+  _NOTE: If you mistype a course, that course will not be created. If you
+  only have mistyped courses, then no courses gets created._
+
 
   NOTE: This command will also have to be run twice a year on July 1st and January 1st when the test semester will change from fall to spring or vice versa.
 

_docs/developer/getting_started/commit_to_PR_from_fork.md

@@ -40,7 +40,15 @@ The instructions below are for command line use of git.
     ```
 
     Additionally, find the name of the fork on the fork's page on Github.  
-    The `fork_name` may simply be `Submitty`, or the author may have chosen to another name.
+    The `fork_name` may simply be `Submitty`, or the author may have chosen another name.
+
+    Note: make sure your git credentials are set before pulling or pushing to a forked 
+    repo. You can do this with the following commands. Use the `--global` flag if you 
+    want to set this outside of just Submitty.
+    ```
+    git config user.name "Your Name"
+    git config user.email "Your Email"
+    ```
     
 
 3.  Next, make a local branch on your computer in your working repository

_docs/developer/getting_started/make_a_pull_request.md

@@ -68,7 +68,7 @@ Be sure to read the [Suggestions for New Developers](/developer/getting_started/
 
       * `Submission` (includes bulk uploads, teams, late days, notebook gradeables, and other student features),
       * `Autograding` (includes router, container/docker),
-      * `Forum`,   
+      * `Forum` (Includes Live Chat),  
       * `Notifications` (includes email and grade inquiries),  
       * `TAGrading` (includes PDF annotation, peer grading),  
       * `InstructorUI` (includes course and gradeable configuration),  

_docs/developer/getting_started/project_ideas.md

@@ -5,26 +5,21 @@ redirect_from:
   - /developer/project_ideas
 ---
 
-[comment]: <> Submitty has been a participating organization of
-[comment]: <> [Google Summer of Code](https://summerofcode.withgoogle.com/)
-[comment]: <> for five successful seasons.
-
-We are thrilled to announce that Submitty has been accepted to [Google
-Summer of Code (GSoC) 2024](https://summerofcode.withgoogle.com/).
-See [Submitty GSoC Application &
-Reports](/developer/google_summer_of_code/index) for more information
-about the application process and to read reports from Submitty GSoC
-contributors in past summers.
-
-[comment]: <> We have applied for selection for
-[comment]: <> Summer 2024 and our Project Ideas list below has been updated.  The
-[comment]: <> organizations selected for Summer 2024 Google Summer of Code will be
-[comment]: <> announced in late February.
-
-[comment]: <> _NOTE: The organizations selected for Summer 2023 Google Summer of
-[comment]: <>   Code will be announced in late February.  The instructions below
-[comment]: <>    are from 2022 and will be updated if Submitty is accepted!_
 
+[comment]: <> We are thrilled to announce that Submitty has been accepted to [Google
+[comment]: <> Summer of Code (GSoC) 20XX](https://summerofcode.withgoogle.com/).
+[comment]: <> See [Submitty GSoC Application &
+[comment]: <> Reports](/developer/google_summer_of_code/index) for more information
+[comment]: <> about the application process and to read reports from Submitty GSoC
+[comment]: <> contributors in past summers.
+
+[comment]: <> Submitty has been a participating organization of [Google Summer of
+[comment]: <> Code](https://summerofcode.withgoogle.com/) for six successful
+[comment]: <> seasons.  [We have applied for selection for Summer 20XX](/developer/google_summer_of_code/index)
+[comment]: <> and our
+[comment]: <> Project Ideas list below has been updated.  The organizations selected
+[comment]: <> for Summer 20XX Google Summer of Code will be announced in late
+[comment]: <> February.
 
 The project ideas listed below target a variety of different topics
 and require different levels of prior experience.  The scope of these
@@ -42,7 +37,43 @@ developers.
 &nbsp;    
 
 
-1. **Expand Testing of the Manual/TA Rubric Grading Interface**
+1. **Interactive User Interfaces With Vue.js**
+
+   Submitty primarily uses server-side rendering via Twig. jQuery is
+   used extensively throughout the site to add interactivity, but it
+   is insufficient for the most complex pages.  Instead, we think
+   Vue.js is a better path forward for pages such as the TA grading
+   interface, discussion forum, office hours queue, and rainbow grades
+   customization interface.  The goal of this project is to explore
+   how we can add and improve interactivity to specific pages and
+   support future development efforts involving the use of Vue.js
+   within Submitty's codebase.
+
+   _Expected Outcomes_: This project is flexible in both scope and size.
+   A successful proposal should include detailed information about the
+   specific pages and components to be converted, including time estimates
+   for the proposed conversion projects and common core logic improvements.
+   Participants will gain a better understanding of the challenges involved
+   in introducing new technologies to a large existing codebase, gain
+   experience architecting a key part of a large project, and grow their
+   knowledge of modern web frameworks.
+
+   [Ongoing Work to Incorporate Vue.js](https://github.com/Submitty/Submitty/pulls?q=is%3Apr+vue+is%3Aclosed+)  
+   [Open Issues related to Vue.js](https://github.com/Submitty/Submitty/issues?q=is%3Aissue%20state%3Aopen%20vue%20)
+
+   _Skills & Experience Required_: Moderate to advanced programming
+   skills, preferably with experience using modern client-side web
+   frameworks. 
+
+   _Possible Mentors_: William Allen, Shail Patel, Chris Reed, Barb Cutler  
+   _GSoC Project Size_: 175 or 350 hours  
+   _Difficulty Level_:  medium to challenging
+
+   &nbsp;
+
+
+
+2. **Expand Testing of the Manual/TA Rubric Grading Interface**
 
    [Overview of Rubric Grading Interface](/grader/rubric_grading/index)
 
@@ -52,7 +83,11 @@ developers.
    tested by automated unit and end-to-end (Cypress) regression testing.
 
    [Open Issues related to TA Grading](https://github.com/Submitty/Submitty/issues?q=is%3Aopen+is%3Aissue+label%3A%22TA+Grading+%2F+TA+UI%22)  
-   [Open Issues related to Sample Data](https://github.com/Submitty/Submitty/issues?q=is%3Aopen+is%3Aissue+label%3A%22Sample+Data%22)
+   [Open Issues related to Sample Data](https://github.com/Submitty/Submitty/issues?q=is%3Aopen+is%3Aissue+label%3A%22Sample+Data%22)  
+   [Related Prior GSoC Project: Cameron Peterson](/developer/google_summer_of_code/2023_Cameron_Peterson)  
+   [Related Prior GSoC Project: Rahul Vishwakarma](/developer/google_summer_of_code/2024_Rahul_Vishwakarma)
+
+   _Note: This project may be combined with the previous project idea._
 
    _Expected Outcomes_: The primary goals for this project include the
    expansion of our automated testing of the TA Grading pages and to
@@ -68,20 +103,18 @@ developers.
    teaching assistant with grading experience design will be
    beneficial.
 
-   _Possible Mentors_: William Allen, Nia Heermance, Barb Cutler
-
-   _GSoC Project Size_: 90 or 175 hours
-
+   _Possible Mentors_: William Allen, Cameron Peterson, Barb Cutler  
+   _GSoC Project Size_: 90 or 175 hours  
    _Difficulty Level_: introductory to medium
 
    &nbsp;    
 
 
-2. **Refactor and Performance Improvements for the Manual/TA Rubric Grading Interface**
+3. **Refactor and Performance Improvements for the Manual/TA Rubric Grading Interface**
 
    [Overview of Rubric Grading Interface](/grader/rubric_grading/index)
 
-   _Note: This project may be combined with the previous project idea._
+   _Note: This project may be combined with one of the previous project ideas._
 
    The Manual/TA rubric grading interface is elaborate,
    highly-featured, and customizable; however, the performance of
@@ -112,16 +145,14 @@ developers.
    and and having served as a teaching assistant with grading
    experience design is beneficial but not required.
 
-   _Possible Mentors_: Nia Heermance, William Allen, Barb Cutler
-
-   _GSoC Project Size_: 175 or 350 hours
-
+   _Possible Mentors_: William Allen, Barb Cutler  
+   _GSoC Project Size_: 175 or 350 hours  
    _Difficulty Level_: medium to challenging
 
    &nbsp;
 
 
-3. **Notebook Builder: UI To Streamline Instructor Configuration of Automated Grading**
+4. **Notebook Builder: UI To Streamline Instructor Configuration of Automated Grading**
 
    Our system for automated testing and grading of student work is
    very powerful, but the configuration process that instructors must
@@ -147,7 +178,8 @@ developers.
    in compiled languages.
 
    [Open Issues related to Autograding](https://github.com/Submitty/Submitty/labels/Autograding)  
-   [Open Issues related to Notebook / Notebook Builder](https://github.com/Submitty/Submitty/issues?q=is%3Aopen+is%3Aissue+label%3A%22Notebook+%2F+Notebook+Builder%22)
+   [Open Issues related to Notebook / Notebook Builder](https://github.com/Submitty/Submitty/issues?q=is%3Aopen+is%3Aissue+label%3A%22Notebook+%2F+Notebook+Builder%22)  
+   [Related Prior GSoC Project: Sahil Suman](/developer/google_summer_of_code/2024_Sahil_Suman)
 
    _Expected Outcomes_: The primary focus of the project is the
    revision and expansion of the Notebook Builder UI to increase the
@@ -165,15 +197,13 @@ developers.
    instructor with experience in programming assignment design will be
    beneficial but not required.
 
-   _Possible Mentors_: Barb Cutler, Chris Reed
-
-   _GSoC Project Size_: 90 or 175 or 350 hours
-
+   _Possible Mentors_: Barb Cutler, Chris Reed  
+   _GSoC Project Size_: 90 or 175 or 350 hours  
    _Difficulty Level_: introductory or medium
 
    &nbsp;    
 
-4. **Expansion of Examples and Documentation of Intermediate and Advanced Autograding Features**
+5. **Expansion of Examples and Documentation of Intermediate and Advanced Autograding Features**
 
    _Note: This project is related to previous project idea but is a distinct project._
 
@@ -187,7 +217,7 @@ developers.
    [Assignment Autograding Configuration Instructions](/instructor/autograding/specification)  
    [Submitty Autograding Tutorial Examples](https://github.com/Submitty/Tutorial)  
    [Additional Autograding Examples](https://github.com/Submitty/Submitty/tree/master/more_autograding_examples)  
-   [Prior GSoC Project: Drumil Patel](/developer/google_summer_of_code/2019_DrumilPatel)  
+   [Related Prior GSoC Project: Drumil Patel](/developer/google_summer_of_code/2019_DrumilPatel)  
 
    We would like to reduce the learning curve for new instructors and
    provide more tutorial examples of autograding for instructors
@@ -202,7 +232,8 @@ developers.
    [Open Issues related to Docker Image Autograding](https://github.com/Submitty/Submitty/issues?q=label%3A%22Docker+Container+Autograding%22+)  
    [Docker Images for Autograding Common Programming Languages](https://github.com/Submitty/DockerImages/tree/main)  
    [Example Custom Docker Images University ](https://github.com/Submitty/DockerImagesRPI/tree/main/dockerfiles)  
-   [Sample Java Assignments](/instructor/autograding/sample_assignments)
+   [Sample Java Assignments](/instructor/autograding/sample_assignments)  
+   [Related Prior GSoC Project: Nithish Reddy Banda](/developer/google_summer_of_code/2024_Nithish_Reddy_Banda)
 
    _Expected Outcomes_: The project should begin with a review and
    organization of existing sample and tutorial assignments and
@@ -221,16 +252,15 @@ developers.
    Having served as a teaching assistant or instructor with experience
    in programming assignment design will be beneficial.
 
-   _Possible Mentors_: Chris Reed, Barb Cutler
-
-   _GSoC Project Size_: 175 or 350 hours
-
+   _Possible Mentors_: Shail Patel, Chris Reed, Barb Cutler  
+   _GSoC Project Size_: 175 or 350 hours  
    _Difficulty Level_: medium to challenging
 
    &nbsp;
 
 
-5. **AI/ML to Enhance and Steamline Manual / TA Grading**
+
+6. **AI/ML to Enhance and Streamline Manual / TA Grading**
 
    The use of a unified and retroactively editable rubric for
    manual/TA grading can ensure consistency when grading large
@@ -285,15 +315,14 @@ developers.
    large course with manual grading experience design will be
    beneficial.
 
-   _Possible Mentors_: Barb Cutler, William Allen, Nia Heermance
-
-   _GSoC Project Size_: 175 or 350 hours
-
+   _Possible Mentors_: Barb Cutler, William Allen  
+   _GSoC Project Size_: 175 or 350 hours  
    _Difficulty Level_:  medium to challenging
 
-   &nbsp;    
+   &nbsp;
 
-6. **Other Topics**
+
+7. **Other Topics**
 
    The Submitty team welcomes GSoC project proposals on other topics
    related to items in our GitHub issue tracker.  A successful
@@ -307,10 +336,8 @@ developers.
    willingness to learn web and database development, and additional
    specific skills as appropriate.
 
-   _Possible Mentors_: Barb Cutler, Matthew Peveler, Shail Patel,  William Allen, Chris Reed, Nia Heermance, Preston Carman
-
-   _GSoC Project Size_: 90 or 175 or 350 hours
-
+   _Possible Mentors_: Barb Cutler, William Allen, Shail Patel, Cameron Peterson, Chris Reed, Matthew Peveler, Preston Carman  
+   _GSoC Project Size_: 90 or 175 or 350 hours  
    _Difficulty Level_:  introductory to medium to challenging
 
 &nbsp;    

_docs/developer/getting_started/vm_install_using_vagrant.md

@@ -121,9 +121,10 @@ M-Series ARM MacOS machines.*
    * You will need:     
       * [Ruby](https://www.ruby-lang.org/en/downloads)  
       * [Git](https://git-scm.com/downloads)  
-      * [Vagrant](https://www.vagrantup.com)  
+      * [Vagrant](https://developer.hashicorp.com/vagrant/install)
       * *M-SERIES ARM MacOS:* [QEMU](https://www.qemu.org)  
-      * *EVERYONE ELSE:* [VirtualBox](https://www.virtualbox.org/wiki/Download_Old_Builds_6_1)  
+      * *EVERYONE ELSE:* [VirtualBox](https://www.virtualbox.org/wiki/Downloads)
+          * Ensure VirtualBox version is compatible with Vagrant.
 
 
    * **MacOS**  
@@ -145,8 +146,8 @@ M-Series ARM MacOS machines.*
       ```
 
    * **Windows**  
-      *You can just go to the respective sites and download the necessary binaries.*
-
+      Download the latest Vagrant AMD64 binary for windows.
+      *As of Vagrant version 2.4.7, Virtualbox 7.1.10 is compatible.*
 
    * **Ubuntu/Debian**