Merge branch 'main' into fix-instructor-doc-typo

bmcutler · web-flow · commit 81d97c13eeae · 2026-04-10T14:45:09.000-04:00
diff --git a/Gemfile.lock b/Gemfile.lock
@@ -39,6 +39,7 @@ GEM
       logger
     faraday-net_http (3.1.1)
       net-http
+    ffi (1.17.2-aarch64-linux-gnu)
     ffi (1.17.2-arm64-darwin)
     ffi (1.17.2-x64-mingw-ucrt)
     ffi (1.17.2-x86_64-linux-gnu)
@@ -239,6 +240,8 @@ GEM
     mutex_m (0.2.0)
     net-http (0.4.1)
       uri
+    nokogiri (1.18.9-aarch64-linux-gnu)
+      racc (~> 1.4)
     nokogiri (1.18.9-arm64-darwin)
       racc (~> 1.4)
     nokogiri (1.18.9-x64-mingw-ucrt)
@@ -284,6 +287,7 @@ GEM
     yell (2.2.2)
 
 PLATFORMS
+  aarch64-linux-gnu
   arm64-darwin-22
   arm64-darwin-23
   arm64-darwin-24
diff --git a/_docs/developer/getting_started/vm_install_using_vagrant.md b/_docs/developer/getting_started/vm_install_using_vagrant.md
@@ -15,8 +15,7 @@ Machine (VM) on your computer and the VM will use the Ubuntu GNU/Linux
 operating system.
 
 ***NOTE:** We only officially support and test development using
-VirtualBox for AMD and Intel machines and QEMU for
-M-Series ARM MacOS machines.*
+VirtualBox.*
 
 ---
 
@@ -51,14 +50,7 @@ M-Series ARM MacOS machines.*
    platform and prevent VirtualBox from working correctly. It is recommended to not install
    or use WSL2 alongside VirtualBox for now.*
 
-5. If you're on an M-series ARM MacOS (e.g., M1, M2, M3),
-   you will be using QEMU with SMB file sharing.
-   To enable this, open **System Settings** and navigate to **General > Sharing**.
-   Press the (i) button next to **File Sharing**, and in the popup window
-   click "Options...". Then turn on "Share files and folders using SMB" and
-   check the box next to your name in the list below.
-
-6. The complete installation process could take an hour or more and 
+5. The complete installation process could take an hour or more and 
    will probably fail if paused or interrupted.  Make
    sure your internet connection is strong and consistent.  You'll
    probably want to plug in your laptop power cord.  Check your
@@ -122,24 +114,14 @@ M-Series ARM MacOS machines.*
       * [Ruby](https://www.ruby-lang.org/en/downloads)  
       * [Git](https://git-scm.com/downloads)  
       * [Vagrant](https://developer.hashicorp.com/vagrant/install)
-      * *M-SERIES ARM MacOS:* [QEMU](https://www.qemu.org)  
-      * *EVERYONE ELSE:* [VirtualBox](https://www.virtualbox.org/wiki/Downloads)
+      * [VirtualBox](https://www.virtualbox.org/wiki/Downloads)
           * Ensure VirtualBox version is compatible with Vagrant.
    
    
    * **MacOS**  
       You can either go to respective sites and download the necessary binaries or
       install [Homebrew](http://brew.sh/), if you don't have it, and then:
 
-      If you have an M-series ARM Mac, run:
-      ```
-      brew install --cask vagrant
-      brew install qemu
-      vagrant plugin install vagrant-qemu
-      ```
-  
-      Or if you have an older Intel-based Mac, run:
-
       ```
       brew install --cask vagrant
       brew install --cask virtualbox
@@ -243,9 +225,6 @@ M-Series ARM MacOS machines.*
 
 
    * **Build pre-packaged VM**
-
-     *NOTE: The pre-packaged Submitty VM is not (yet)
-     available for QEMU / M-Series ARM Mac machines.*
  
      If you are using VirtualBox as your provider, you will by default
      use a pre-packaged Submitty VM.  This will have all of Submitty
@@ -285,13 +264,8 @@ M-Series ARM MacOS machines.*
 
 
    * **Build from scratch**
-
-      * Using QEMU on an M-Series Arm MacOS, type:
-        ```
-        vagrant up --provider=qemu
-        ```
  
-      * On Linux or Intel-based Mac, type:
+      * On Linux or Mac, type:
         ```
         FROM_SCRATCH=1 vagrant up --provider=virtualbox
         ```
@@ -326,12 +300,7 @@ M-Series ARM MacOS machines.*
      creation of these sample submissions and their autograding and
      decrease the time to complete installation.
 
-     * On M-series ARM Mac:
-       ```
-       NO_SUBMISSIONS=1 vagrant up --provider=qemu
-       ```
-
-     * On Linux or Intel-based Mac:  
+     * On Linux or Mac:  
        ```
        NO_SUBMISSIONS=1 FROM_SCRATCH=1 vagrant up --provider=virtualbox
        ```
diff --git a/_docs/developer/getting_started/worker_vm.md b/_docs/developer/getting_started/worker_vm.md
@@ -31,22 +31,7 @@ machines* in addition to your primary vagrant virtual machine.
 
    _NOTE: This will create the vagrant configuration file: `.vagrant/workers.json`._
 
-
-4. If you are on MacOS running QEMU, restart the network socket in public mode:
-   ```
-   vagrant workers socket restart --public
-   ```
-   _NOTE: Using the `--public` flag will make your worker VMs accessible to anyone
-   on your local network, which may be a modest security concern.
-   We suggest this to minimize possibility of errors while creating the
-   worker machines and will revert this in a later step._
-
-   _NOTE: Running a socket command while a worker machine is running can detach the
-   process, making the VM inaccessible to vagrant. If this happens and you are unable
-   to `vagrant workers halt`, then you may run `pkill -15 -f qemu-system-` to kill
-   all virtual machines running on your computer (including the main Submitty VM)._
-
-6. Now you can create the worker machine(s) with:
+4. Now you can create the worker machine(s) with:
    ```
    vagrant workers up
    ```
@@ -55,26 +40,23 @@ machines* in addition to your primary vagrant virtual machine.
 
    When this is finished, you should see the Submitty duck ASCII art for each new worker machine.
 
-7. You can verify that all the worker machines are running with:
+5. You can verify that all the worker machines are running with:
    ```
    vagrant workers status
    ```
 
-8. `vagrant ssh` into the main virtual machine and run:
+6. `vagrant ssh` into the main virtual machine and run:
    ```
    refresh_vagrant_workers   # (runs python3 /usr/local/submitty/GIT_CHECKOUT/Submitty/.setup/bin/refresh_vagrant_workers.py)
    submitty_install
    ```
 
-9. To stop the worker machines, you can run:
+7. To stop the worker machines, you can run:
    ```
    vagrant workers halt
    vagrant workers socket stop
    ```
 
-   _For MacOS QEMU users: Once the virtual machine(s) are halted, if you would like to restart under
-   private networking, you may do so by omitting the `--public` flag from the `vagrant workers socket start` command._
-
 
 ---
 
diff --git a/_docs/developer/troubleshooting/installation_troubleshooting.md b/_docs/developer/troubleshooting/installation_troubleshooting.md
@@ -190,7 +190,7 @@ References and useful links: [https://gist.github.com/pjdietz/5768124](https://g
 
 ## SSH connection was unexpectedly closed
 
-* If you see an error similar to on ARM64 Machine (Apple Silicon):
+* If you see an error similar to:
 
   ```
   The SSH connection was unexpectedly closed by the remote end. This
@@ -219,19 +219,10 @@ References and useful links: [https://gist.github.com/pjdietz/5768124](https://g
   vagrant box update
   ```
 
-* Verify qemu is install correctly
-
-  * Firstly, use this command will display the installed version of QEMU for ARM64. 
-    ```
-    qemu-system-aarch64 --version
-    ```
-      
-  * Secondly, Verify that the QEMU binary for ARM64 is accessible in your system's PATH by running:
-    ```
-    which qemu-system-aarch64
-    ```
-
-    *Note: This command will display the path to the QEMU ARM64 binary (e.g., /opt/homebrew/bin/qemu-system-aarch64)
+* Verify Virtualbox is install correctly
+  ```
+  VirtualBox -h
+  ```
 
 * Verify Vagrant Installation
   ```
@@ -262,9 +253,9 @@ References and useful links: [https://gist.github.com/pjdietz/5768124](https://g
   vagrant destroy
   ```
 
-* Boots up a new Vagrant environment using the QEMU provider
+* Boots up a new Vagrant environment
   ```
-  vagrant up --provider=qemu
+  vagrant up --provider=virtualbox
   ```
 
 ---
diff --git a/_docs/instructor/assignment_preparation/no_file_rubric_grading.md b/_docs/instructor/assignment_preparation/no_file_rubric_grading.md
@@ -0,0 +1,48 @@
+---
+category: Instructor > Assignment Preparation
+title: No File Rubric Grading
+redirect_from:
+  - /instructor/no_file_rubric_grading
+---
+
+The **No File Rubric Grading** feature is a utility within the Bulk Upload instructor submission interface. It allows instructors to automatically submit an empty "placeholder" pdf submission for **every** active student on a specific gradeable. 
+
+An example of when this would be useful is for an assignment (like a presentation) where students do not have anything to submit to Submitty, but the instructor still wishes to grade them through Submitty.
+
+In this case, an instructor can use the **No File Rubric Grading** feature to enable rubric grading for all students. 
+
+---
+
+## How to Use this Feature
+
+1. **Create the Gradeable:** Ensure your gradeable is set to the 
+   type: *"TA/Instructor will (bulk) upload scanned .pdf"*.
+   
+2. **Access the Submission Page:** Navigate to the gradeables page and click the 
+   **Bulk Upload** tab.
+
+3. **Click "No File Rubric Grading":** This button is located 
+   near the top of the Bulk Upload section alongside the other submission modes.
+
+4. **Click "Submit Placeholder for Every Student":** This will actually submit the pdf
+   placeholders for every student on the gradeable. After confirming, a message will appear at the top of the screen displaying the successful number of submissions made.  
+   ![](/images/instructor/assignment_preparation/no_file_rubric_grading.png){:width="800px"}
+
+**Important:** This action **will** create 
+a new submission for all students on the gradeable. It will appear as the student's
+active version within the grading view and on the database. It will not erase any 
+previous submissions.
+
+---
+
+## Grading
+
+Once the submissions have been processed, they can be graded like any other student submission. They will be listed as a new version under the student's version status. Further uses of the function (while uneccessary) will simply increment the version number.
+
+---
+
+## Troubleshooting
+
+Ensure you are logged in as an Instructor level user.  
+Full grading access is required to use this feature. 
+There is currently no Team gradeable functionality for this feature. 
diff --git a/_docs/instructor/course_management/course_materials.md b/_docs/instructor/course_management/course_materials.md
@@ -30,9 +30,11 @@ Materials" label in the navigation bar.
     ![](/images/course_materials_option_subdir.png)  
 
 * Note: The total size of all files uploaded at one time must be less
-  than or equal to 10 mb or the value of the
+  than or equal to 100 mb or the value of the
   [upload file size limit](/sysadmin/installation/system_customization#allowing-large-student-file-upload-submissions)
-  for your server.
+  for your server, and the total size of all files stored in course materials must 
+  be less than 1 GB.
+
 
 
 
diff --git a/_docs/sysadmin/configuration/course_creation.md b/_docs/sysadmin/configuration/course_creation.md
@@ -154,11 +154,27 @@ you can follow these [instructions](ansible_course_creation) to create a course
    For more information: [Database Overview](/sysadmin/troubleshooting/database_overview)
 
 
-3. Add existing instructor(s) to the course database:
+3. Add existing instructor(s) to the course database, and optionally add other 
+   types of users using the `adduser_course.py` helper script.
+   To add an existing instructor:
 
    ```
-   sudo /usr/local/submitty/sbin/adduser_course.py <USERNAME> <SEMESTER> <COURSE> null
+   sudo /usr/local/submitty/sbin/adduser_course.py <INSTRUCTOR_USERNAME> <SEMESTER> <COURSE> --user_group 1
    ```
+   The general command format is:
+
+   ```
+   sudo /usr/local/submitty/sbin/adduser_course.py <USER_ID> <SEMESTER> <COURSE> [REGISTRATION_SECTION] [--user_group GROUP]
+   ```
+
+   - `REGISTRATION_SECTION` is optional and must be numeric.
+
+   - `--user_group` defines the user's role in the course and defaults to `1` (Instructor) if omitted.
+
+     - `1` – Instructor  
+     - `2` – Full Access Grader  
+     - `3` – Limited Access Grader  
+     - `4` – Student  
 
 
 4. Create registration section(s):
diff --git a/images/instructor/assignment_preparation/no_file_rubric_grading.png b/images/instructor/assignment_preparation/no_file_rubric_grading.png
diff --git a/navtreedata.js b/navtreedata.js
@@ -114,6 +114,7 @@ var NAVTREE =
                 [ "Submissions via Version Control", "/instructor/assignment_preparation/submission_version_control", null ],
                 [ "Team Assignments", "/instructor/assignment_preparation/team_assignments", null ],
                 [ "Bulk PDF Upload", "/instructor/assignment_preparation/bulk_pdf_upload", null ],
+                [ "No File Rubric Grading", "/instructor/assignment_preparation/no_file_rubric_grading", null],
                 [ "Personalized Exam", "/instructor/assignment_preparation/personalized_exams", null ],
                 [ "Upload Gradeable from JSON", "/instructor/assignment_preparation/upload_gradeable", null ],
             ] ],
