Skip to content

[Feature:Submission] Update Submit-by-Git gradeable messaging#12359

Merged
bmcutler merged 13 commits intomainfrom
12357-improve-on-page-submit-by-git-instructions-with-access-tokens
Feb 15, 2026
Merged

[Feature:Submission] Update Submit-by-Git gradeable messaging#12359
bmcutler merged 13 commits intomainfrom
12357-improve-on-page-submit-by-git-instructions-with-access-tokens

Conversation

@roye2
Copy link
Contributor

@roye2 roye2 commented Jan 29, 2026

Partially addresses #12357

New Behavior:
A message now appears explaining the submission process on Submit-by-Git gradeables.

What steps should a reviewer take to reproduce or test the bug or new feature?

  1. Open a VCS Gradeable on Submitty
  2. Observe that underneath the git clone line, the new message appears:
image

Automated Testing & Documentation

Note from Emma: I left this part in because I wasn't sure how to answer it. I can update it later.

Other information

Thus is not a breaking change.
There are no security concerns associated.
The second part of Issue #12357 will be addressed in a separate PR.

@roye2 roye2 linked an issue Jan 29, 2026 that may be closed by this pull request
@github-project-automation github-project-automation bot moved this to Seeking Reviewer in Submitty Development Jan 29, 2026
@roye2 roye2 changed the title [Feature][Submission] Updated Submit-by-Git gradeables to include a new message regarding VCS / GIT Authentication Tokens [Feature] [Submission] Updated Submit-by-Git gradeables to include a new message regarding VCS / GIT Authentication Tokens Jan 29, 2026
@codecov
Copy link

codecov bot commented Jan 29, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 21.67%. Comparing base (9c7283a) to head (ebfc910).
⚠️ Report is 9 commits behind head on main.

Additional details and impacted files

Impacted file tree graph

@@            Coverage Diff            @@
##               main   #12359   +/-   ##
=========================================
  Coverage     21.67%   21.67%           
  Complexity     9623     9623           
=========================================
  Files           268      268           
  Lines         36171    36171           
  Branches        486      486           
=========================================
  Hits           7840     7840           
  Misses        27849    27849           
  Partials        482      482           
Flag Coverage Δ
autograder 21.39% <ø> (ø)
js 2.04% <ø> (ø)
migrator 100.00% <ø> (ø)
php 20.69% <ø> (ø)
python_submitty_utils 80.08% <ø> (ø)
submitty_daemon_jobs 90.72% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@roye2 roye2 changed the title [Feature] [Submission] Updated Submit-by-Git gradeables to include a new message regarding VCS / GIT Authentication Tokens [Feature] [Submission] Updated Submit-by-Git gradeables messaging Jan 29, 2026
<samp>git clone {{ repository_path }} SPECIFY_TARGET_DIRECTORY </samp><br><br>
<span><em>You will log in using </em> '<code>{{user_id}}</code>'<em> as your username and VCS / GIT Authentication Token as the password. Click the button below to generate a VCS / GIT Authentication Token for Submitty if this is your first time using GIT with Submitty. </em></span>
{# Below will get uncommented once SAML is active #}
{# <p>You will need to use an Authentication Token.</p> #}
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hmm, this forgotten note about SAML and being required to use an Authentication token should be addressed. At RPI, we are using SAML and students cannot use their password -- they must use the authentication tokens. This commented out message should print out at RPI.

But it should not print for some other school does not use SAML and does allow students to use their password for GIT (or using the authentication token is also allowed).

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@roye2 we should try to test with and without saml
(these step are to configure a server for saml -- might not go smoothly on vagrant)
https://submitty.org/sysadmin/configuration/saml_authentication

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looking at the lines below, it does look like it was addressed but we just forgot to remove the TODO comment. Whoops... Feel free to remove that comment in this PR @roye2.

See https://github.com/Submitty/Submitty/blob/main/.setup/testing/setup_saml.sh if you want to setup SAML on the vagrant box. I don't know if anyone has tested that script locally in a while but should still work since we test SAML in CI.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, I'll take a look and make sure everything's working when I remove the comment. I can also test the SAML script locally just to make sure.

@roye2 roye2 changed the title [Feature] [Submission] Updated Submit-by-Git gradeables messaging [Feature:Submission] Updated Submit-by-Git gradeables messaging Jan 30, 2026
@roye2 roye2 changed the title [Feature:Submission] Updated Submit-by-Git gradeables messaging [Feature:Submission] Update Submit-by-Git gradeable messaging Jan 30, 2026
roye2 added 2 commits February 3, 2026 17:36
… updated formatting on Authentication token page :)
…ccess-tokens' of https://github.com/Submitty/Submitty into 12357-improve-on-page-submit-by-git-instructions-with-access-tokens
@roye2
Copy link
Contributor Author

roye2 commented Feb 3, 2026

Updated Changes Summary + Screenshots:
Screenshot 2026-02-03 at 17-48-46 Open VCS Homework - Sample

Screenshot 2026-02-03 at 17-48-16 Submit-by-Git team test - Sample

Added new messaging from previous commits to Team VCS Gradeables.
Added a new message to all VCS Gradeables: "Note: Your school requires that you use Authentication Tokens." (just above the blue button).
This message displays only if your school requires it due to using Saml as their authentication method.

@github-project-automation github-project-automation bot moved this from Seeking Reviewer to Work in Progress in Submitty Development Feb 4, 2026
roye2 and others added 2 commits February 5, 2026 12:03
Co-authored-by: Chris Reed <55092742+cjreed121@users.noreply.github.com>
@roye2 roye2 requested a review from cjreed121 February 6, 2026 15:04
@automateprojectmangement automateprojectmangement bot moved this from Work in Progress to In Review in Submitty Development Feb 6, 2026
Copy link
Member

@cjreed121 cjreed121 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changes look good after my last 2 comments

@github-project-automation github-project-automation bot moved this from In Review to Awaiting Maintainer Review in Submitty Development Feb 8, 2026
Co-authored-by: Chris Reed <55092742+cjreed121@users.noreply.github.com>
Copy link
Contributor

@Rkoester47 Rkoester47 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The changes made on this branch work as described by the PR. I believe adding these messages will be helpful for students who are new to using this part of Submitty. I agree with the wording changes made in a recent commit as well, providing more clear messaging for users. Your implementation also looks solid and intuitive. Overall, good work!

the TeamView.php file did not pass the user id into the Team.twig file, causing a bug.
@bmcutler bmcutler merged commit 1da7299 into main Feb 15, 2026
25 checks passed
@bmcutler bmcutler deleted the 12357-improve-on-page-submit-by-git-instructions-with-access-tokens branch February 15, 2026 04:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Archived in project

Development

Successfully merging this pull request may close these issues.

Improve on-page submit-by-git instructions with access tokens

5 participants