MarkUsProject · david-yz-liu · Jul 9, 2026 · Jul 8, 2026 · Jul 9, 2026
diff --git a/Changelog.md b/Changelog.md
@@ -7,6 +7,7 @@
 ### 🚨 Breaking changes
 
 ### ✨ New features and improvements
+- Updated links to refer to new documentation website (#8049)
 - Migrated `AnnotationUsagePanel` component to use `react-table` v8 (#8021)
 - Migrated `SummaryPanel` component to React Table V8 (#8019)
 - Migrated `graders_manager.jsx` file's `GradersTable`, `GroupsTable`, `CriteriaTable` to use `react-table` v8 (#8014)

diff --git a/app/javascript/Components/Modals/graders_distribution_modal.jsx b/app/javascript/Components/Modals/graders_distribution_modal.jsx
@@ -55,9 +55,7 @@ export class GraderDistributionModal extends React.Component {
             <h2>{I18n.t("graders.weight")}</h2>
             <p className="auto-overflow" style={{maxWidth: "300px"}}>
               {I18n.t("graders.random_instruction")}
-              <a
-                href={`https://github.com/MarkUsProject/Wiki/blob/${MARKUS_VERSION}/Instructor-Guide--Assignments--Assigning-Graders.md`}
-              >
+              <a href={`${DOCS_URL}/instructors/assignments/assigning-graders/`}>
                 {" " + I18n.t("graders.wiki")}
               </a>
             </p>

diff --git a/app/javascript/Components/__tests__/graders_distribution_modal.test.jsx b/app/javascript/Components/__tests__/graders_distribution_modal.test.jsx
@@ -22,7 +22,6 @@ describe("GraderDistributionModal", () => {
       isOpen: true,
       onSubmit: jest.fn().mockImplementation(() => (props.isOpen = false)),
     };
-    global.MARKUS_VERSION = "master";
     jest.spyOn(window, "FormData").mockImplementationOnce(() => form1);
   });
 

diff --git a/app/views/admin/users/_upload_modal.html.erb b/app/views/admin/users/_upload_modal.html.erb
@@ -5,7 +5,7 @@
 <%= content_for :modal_content do %>
 
   <p>
-    <%= t('users.admin_csv_upload_help_html', markus_version: Rails.configuration.markus_version) %>
+    <%= t('users.admin_csv_upload_help_html', docs_url: Settings.docs_url) %>
   </p>
   <%= form_tag upload_admin_users_path, { multipart: true } do %>
     <div>

diff --git a/app/views/annotation_categories/_annotation_upload_modal.html.erb b/app/views/annotation_categories/_annotation_upload_modal.html.erb
@@ -4,7 +4,7 @@
 
 <%= content_for :modal_content do %>
 
-  <%= t('upload_help_html', markus_version: Rails.configuration.markus_version, section_id: AnnotationCategory.name.pluralize.underscore.dasherize) %>
+  <%= t('upload_help_html', docs_url: Settings.docs_url, section_id: AnnotationCategory.name.pluralize.underscore.dasherize) %>
   <%= form_tag({ action: 'upload' },
                { multipart: true }) do %>
     <p><%= file_field_tag :upload_file, required: true, accept: '.csv,.yml,.yaml' %></p>

diff --git a/app/views/assignments/_assignment_upload_modal.html.erb b/app/views/assignments/_assignment_upload_modal.html.erb
@@ -4,7 +4,7 @@
 
 <%= content_for :modal_content do %>
 
-  <%= t('upload_help_html', markus_version: Rails.configuration.markus_version, section_id: Assignment.name.pluralize.underscore.dasherize) %>
+  <%= t('upload_help_html', docs_url: Settings.docs_url, section_id: Assignment.name.pluralize.underscore.dasherize) %>
 
   <%= form_tag upload_assignments_course_path(@current_course),
                { multipart: true } do %>

diff --git a/app/views/assignments/_cp_assignment_upload_modal.html.erb b/app/views/assignments/_cp_assignment_upload_modal.html.erb
@@ -4,7 +4,7 @@
 
 <%= content_for :modal_content do %>
 
-  <%= t('assignments.upload_config_help_html', markus_version: Rails.configuration.markus_version, section_id: 'assignment-configuration') %>
+  <%= t('assignments.upload_config_help_html', docs_url: Settings.docs_url, section_id: 'assignment-configuration') %>
 
   <%= form_tag upload_config_files_course_assignments_path(@current_course),
                { multipart: true } do %>

diff --git a/app/views/criteria/_upload_modal.html.erb b/app/views/criteria/_upload_modal.html.erb
@@ -10,7 +10,7 @@
       <p><%= t('assignments.due_date.marking_overwrite_warning_html') %></p>
     </div>
   <% end %>
-  <%= t('upload_help_html', markus_version: Rails.configuration.markus_version, section_id: Criterion.name.pluralize.underscore.dasherize) %>
+  <%= t('upload_help_html', docs_url: Settings.docs_url, section_id: Criterion.name.pluralize.underscore.dasherize) %>
   <%= form_tag upload_course_assignment_criteria_path(@current_course, @assignment),
                multipart: true, size: 1 do %>
     <p><%= file_field_tag :upload_file, required: true, accept: '.yaml,.yml' %></p>

diff --git a/app/views/exam_templates/_manager_help.html.erb b/app/views/exam_templates/_manager_help.html.erb
@@ -1,7 +1,7 @@
 <div id='exam_template_help'>
   <h2><%= t(:help) %></h2>
   <%= t('exam_templates.help_manual_html',
-        markus_version: Rails.configuration.markus_version,
+        docs_url: Settings.docs_url,
         template_division_title: ExamTemplate.human_attribute_name('template_divisions'),
         automatic_parsing_title: t('exam_templates.parsing.title')) %>
 </div>
diff --git a/app/views/grade_entry_forms/_upload_modal.html.erb b/app/views/grade_entry_forms/_upload_modal.html.erb
@@ -3,7 +3,7 @@
 <%= content_for :modal_open_link, '#uploadModal' %>
 
 <%= content_for :modal_content do %>
-  <%= t('upload_help_html', markus_version: Rails.configuration.markus_version, section_id: 'marks-spreadsheet-grades') %>
+  <%= t('upload_help_html', docs_url: Settings.docs_url, section_id: 'marks-spreadsheet-grades') %>
 
   <%= form_tag upload_course_grade_entry_form_path(@current_course, @grade_entry_form),
                { multipart: true, size: 1 } do %>

diff --git a/app/views/graders/_upload_modal.html.erb b/app/views/graders/_upload_modal.html.erb
@@ -4,7 +4,7 @@
 
 <%= content_for :modal_content do %>
 
-  <%= t('upload_help_html', markus_version: Rails.configuration.markus_version, section_id: 'graders') %>
+  <%= t('upload_help_html', docs_url: Settings.docs_url, section_id: 'graders') %>
 
   <%= form_tag upload_course_assignment_graders_path(@current_course, @assignment),
                { multipart: true } do %>

diff --git a/app/views/groups/_upload_modal.html.erb b/app/views/groups/_upload_modal.html.erb
@@ -5,7 +5,7 @@
 <%= content_for :modal_content do %>
 
   <p>
-    <%= t('upload_help_html', markus_version: Rails.configuration.markus_version, section_id: 'groups') %>
+    <%= t('upload_help_html', docs_url: Settings.docs_url, section_id: 'groups') %>
   </p>
   <%= form_tag upload_course_assignment_groups_path(@current_course, @assignment),
                { multipart: true } do %>

diff --git a/app/views/layouts/_head.html.erb b/app/views/layouts/_head.html.erb
@@ -18,6 +18,6 @@
 <% end %>
 <%= javascript_tag("const AUTH_TOKEN = document.querySelector('[name=\"csrf-token\"]').content;", nonce: true) if protect_against_forgery? %>
 <%= javascript_tag nonce: true do %>
-  const MARKUS_VERSION = '<%= Rails.configuration.markus_version %>';
+  const DOCS_URL = '<%= Settings.docs_url %>';
   const I18N_LOCALE = '<%= I18n.locale %>';
 <% end %>
diff --git a/app/views/layouts/_header.html.erb b/app/views/layouts/_header.html.erb
@@ -49,7 +49,7 @@
             <% end %>
             <li>
               <i class="fa-solid fa-question"></i>
-              <a href="https://github.com/MarkUsProject/Wiki/blob/<%= Rails.configuration.markus_version %>/Home.md">
+              <a href="<%= Settings.docs_url %>">
                 <%= t(:help) %>
               </a>
             </li>

diff --git a/app/views/marks_graders/_upload_modal.html.erb b/app/views/marks_graders/_upload_modal.html.erb
@@ -3,7 +3,7 @@
 <%= content_for :modal_open_link, '#uploadModal' %>
 
 <%= content_for :modal_content do %>
-  <%= t('upload_help_html', markus_version: Rails.configuration.markus_version, section_id: 'graders') %>
+  <%= t('upload_help_html', docs_url: Settings.docs_url, section_id: 'graders') %>
 
   <%= form_tag({ controller: 'marks_graders',
                  action: 'upload' },

diff --git a/app/views/peer_reviews/_upload_modal.html.erb b/app/views/peer_reviews/_upload_modal.html.erb
@@ -4,7 +4,7 @@
 
 <%= content_for :modal_content do %>
 
-  <%= t('upload_help_html', markus_version: Rails.configuration.markus_version, section_id: 'peer-reviews') %>
+  <%= t('upload_help_html', docs_url: Settings.docs_url, section_id: 'peer-reviews') %>
 
   <%= form_tag({ controller: 'peer_reviews',
                  action: 'upload' },

diff --git a/app/views/students/_upload_modal.html.erb b/app/views/students/_upload_modal.html.erb
@@ -5,7 +5,7 @@
 <%= content_for :modal_content do %>
 
   <p>
-    <%= t('upload_help_html', markus_version: Rails.configuration.markus_version, section_id: 'students') %>
+    <%= t('upload_help_html', docs_url: Settings.docs_url, section_id: 'students') %>
   </p>
   <%= form_tag upload_course_students_path(@current_course), { multipart: true } do %>
     <div>

diff --git a/app/views/tags/_upload_modal.html.erb b/app/views/tags/_upload_modal.html.erb
@@ -4,7 +4,7 @@
 
 <%= content_for :modal_content do %>
 
-  <%= t('upload_help_html', markus_version: Rails.configuration.markus_version, section_id: 'tags') %>
+  <%= t('upload_help_html', docs_url: Settings.docs_url, section_id: 'tags') %>
 
   <%= form_tag upload_course_tags_path(@current_course, assignment_id: @assignment.id),
                { multipart: true, size: 1 } do %>

diff --git a/app/views/tas/_upload_modal.html.erb b/app/views/tas/_upload_modal.html.erb
@@ -4,7 +4,7 @@
 
 <%= content_for :modal_content do %>
   <p>
-    <%= t('upload_help_html', markus_version: Rails.configuration.markus_version, section_id: 'students') %>
+    <%= t('upload_help_html', docs_url: Settings.docs_url, section_id: 'tas') %>
   </p>
   <%= form_tag upload_course_tas_path(@current_course), { multipart: true } do %>
     <div>

diff --git a/app/views/users/_key_display.html.erb b/app/views/users/_key_display.html.erb
@@ -3,7 +3,7 @@
     <%= User.human_attribute_name(:api_key) %>
     <div class='help'>
       <p>
-        <%= t('users.api_key.help_html', markus_version: Rails.configuration.markus_version,) %>
+        <%= t('users.api_key.help_html', docs_url: Settings.docs_url,) %>
       </p>
     </div>
   </h2>

diff --git a/app/views/users/settings.html.erb b/app/views/users/settings.html.erb
@@ -57,12 +57,12 @@
   <hr>
   <h3><%= t('help') %></h3>
   <p>
-    <a href="https://github.com/MarkUsProject/Wiki/blob/<%= Rails.configuration.markus_version %>/SSH_Keypair_Instructions_Windows.md" target="_blank">
+    <a href="<%= Settings.docs_url %>/instructors/key-pairs/windows/" target="_blank">
       <%= t('key_pairs.help.windows') %>
     </a>
   </p>
   <p>
-    <a href="https://github.com/MarkUsProject/Wiki/blob/<%= Rails.configuration.markus_version %>/SSH_Keypair_Instructions_Linux-OSX.md" target="_blank">
+    <a href="<%= Settings.docs_url %>/instructors/key-pairs/linux-osx/" target="_blank">
       <%= t('key_pairs.help.macOS_linux') %>
     </a>
   </p>

diff --git a/config/initializers/config.rb b/config/initializers/config.rb
@@ -191,6 +191,7 @@
         optional(:lti).filled(:string)
         optional(:repos).filled(:string)
       end
+      optional(:docs_url).filled(:string)
       optional(:lti).hash do
         optional(:course_filter_file).filled(:string)
         required(:domains).array(:str?)

diff --git a/config/locales/defaults/download_upload/en.yml b/config/locales/defaults/download_upload/en.yml
@@ -26,7 +26,7 @@ en:
     unparseable_csv: The selected file is not a CSV file (even though it may have a .csv extension).
     zip_entry_too_large: Zip entry %{file_name} exceeds the maximum file size of %{max_size} MB.
     zip_too_large_total: Zip file uncompressed size exceeds the maximum of %{max_mb} MB.
-  upload_help_html: ' For information about the file format(s) supported, please visit <a href="https://github.com/MarkUsProject/Wiki/blob/%{markus_version}/Instructor-Guide--Importing-and-Exporting-Data.md#%{section_id}">this page</a>.'
+  upload_help_html: ' For information about the file format(s) supported, please visit <a href="%{docs_url}/instructors/importing-and-exporting-data/#%{section_id}">this page</a>.'
   upload_success:
     one: "%{count} object successfully uploaded."
     other: "%{count} objects successfully uploaded."

diff --git a/config/locales/views/admin/en.yml b/config/locales/views/admin/en.yml
@@ -8,4 +8,4 @@ en:
   markus_administration: MarkUs Administration
   monitoring: Monitoring
   users:
-    admin_csv_upload_help_html: For more information about this feature and the<br>file format(s) supported, please visit <a href="https://github.com/MarkUsProject/Wiki/blob/%{markus_version}/Admin-Guide.md#bulk-uploading-of-end-users">this page</a>.
+    admin_csv_upload_help_html: For more information about this feature and the<br>file format(s) supported, please visit <a href="%{docs_url}/administrators/#bulk-uploading-of-end-users">this page</a>.
diff --git a/config/locales/views/assignments/en.yml b/config/locales/views/assignments/en.yml
@@ -107,7 +107,7 @@ en:
     upload_config_files:
       errors:
         invalid_starter_file_group_dirname: 'Invalid directory_name for starter file group: %{directory_name}'
-    upload_config_help_html: "<p>This zip file will configure and create this assignment.</p><p>This does not configure student or grader settings.<br>For more information please visit <a href=https://github.com/MarkUsProject/Wiki/blob/%{markus_version}/Instructor-Guide--Importing-and-Exporting-Data.md#%{section_id}>this page</a>.</p>"
+    upload_config_help_html: <p>This zip file will configure and create this assignment.</p><p>This does not configure student or grader settings.<br>For more information please visit <a href="%{docs_url}/instructors/importing-and-exporting-data/#%{section_id}">this page</a>.</p>
     upload_file_requirement: Filename %{file_name} is not allowed for this assignment.
     upload_file_requirement_in_folder: Filename %{file_name} in %{file_path} is not allowed for this assignment.
     upload_grades:

diff --git a/config/locales/views/exam_templates/en.yml b/config/locales/views/exam_templates/en.yml
@@ -47,7 +47,7 @@ en:
       title: Generate Exam Copies
     help_manual_html: |
       <p>
-        For more details on any of these steps and more, please visit the <a href=https://github.com/MarkUsProject/Wiki/blob/%{markus_version}/Instructor-Guide--Scanned-Exams.md>MarkUs wiki</a>.
+        For more details on any of these steps and more, please visit the <a href="%{docs_url}/instructors/scanned-exams/">MarkUs documentation website</a>.
       </p> <h3>Editing Exam Templates</h3> <p>
         Select an Exam Template on the left to edit it. In addition to changing the name and template file you may also
         make changes to the following:
@@ -68,7 +68,7 @@ en:
             If enabled, MarkUs will attempt to scan a portion of the test cover page and parse handwriting corresponding
             to either a student's user name or ID number. MarkUs will then attempt to match the test paper to a student
             in the course. This feature is not designed to replace the manual matching process. For more details please
-            consult the <a href=https://github.com/MarkUsProject/Wiki/blob/%{markus_version}/Instructor-Guide--Scanned-Exams.md#automatic-parsing-of-student-information>wiki</a>.
+            consult the <a href="%{docs_url}/instructors/scanned-exams/#automatic-matching-of-student-papers">documentation</a>.
           </p>
         </li>
       </ul> <h3>Uploading Completed Test Papers</h3> <p>

diff --git a/config/locales/views/graders/en.yml b/config/locales/views/graders/en.yml
@@ -33,4 +33,4 @@ en:
     upload:
       remove_existing_mappings: Remove existing grader assignments
     weight: Grader Weight
-    wiki: See our wiki for more information.
+    wiki: See our documentation website for more information.
diff --git a/config/locales/views/users/en.yml b/config/locales/views/users/en.yml
@@ -43,7 +43,7 @@ en:
   users:
     account_settings: Account Settings
     api_key:
-      help_html: The API key is used for authentication for the MarkUs API. See <a href="https://github.com/MarkUsProject/Wiki/blob/%{markus_version}/RESTful-API.md">MarkUs Wiki</a> for information on using the API.
+      help_html: The API key is used for authentication for the MarkUs API. See <a href="%{docs_url}/technical-guides/restful-api/">the MarkUs documentation website</a> for information on using the API.
       reset: Reset API key
       unavailable: Unavailable
     not_found: 'No user can be found with the user name: %{user_names}'

diff --git a/config/settings/development.yml b/config/settings/development.yml
@@ -38,6 +38,8 @@ logging:
 autotest:
   max_batch_size: 10
 
+docs_url: http://localhost:4000
+
 lti:
   adapter_file: <%= "#{::Rails.root}/config/dummy_lti_config.rb" %>
   domains: <%= %w[host.docker.internal] %>

diff --git a/config/settings/production.yml b/config/settings/production.yml
@@ -32,6 +32,8 @@ logging:
 autotest:
   max_batch_size: 500
 
+docs_url: https://markus-docs.teach.cs.toronto.edu
+
 # The settings below are for an experimental feature that is not available
 # in production yet. Please disregard for now.
 lti:

diff --git a/config/settings/test.yml b/config/settings/test.yml
@@ -38,5 +38,7 @@ lti:
   unpermitted_new_course_message: 'You are not permitted to create a new MarkUs course for %{course_name}. Please contact your system administrator.'
   sync_schedule: "0 3 * * *"
 
+docs_url: http://localhost:4000
+
 file_storage:
   default_root_path: <%= "#{::Rails.root}/data/#{::Rails.env}#{ENV['TEST_ENV_NUMBER']}/" %>
diff --git a/doc/README_FOR_APP b/doc/README_FOR_APP
diff --git a/docs/_config.yml b/docs/_config.yml
@@ -1,6 +1,7 @@
 destination: /jekyll/site
 cache_dir: /jekyll/cache
 
+url: https://markus-docs.teach.cs.toronto.edu
 title: MarkUs Docs
 description: Documentation for MarkUs — a web-based tool for the submission and grading of student programming assignments.
 theme: just-the-docs

diff --git a/jest_env_setup.js b/jest_env_setup.js
@@ -11,3 +11,5 @@ window.$ = window.jQuery = global.jQuery = global.$ = $;
 import {I18n} from "i18n-js";
 import translations from "translations.json";
 window.I18n = new I18n(translations);
+
+global.DOCS_URL = "http://localhost:4000";