From 03d7ce9afa21363e50a2171e9a9191e6f6ce0c87 Mon Sep 17 00:00:00 2001 From: Andrew Scholer Date: Fri, 5 Dec 2025 11:30:46 -0800 Subject: [PATCH 1/2] Increase ToC depth --- publication/publication-academy.ptx | 3 ++- publication/publication.ptx | 2 +- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/publication/publication-academy.ptx b/publication/publication-academy.ptx index b6dce8a9..a4da7538 100644 --- a/publication/publication-academy.ptx +++ b/publication/publication-academy.ptx @@ -2,7 +2,8 @@ - + + diff --git a/publication/publication.ptx b/publication/publication.ptx index 3b114535..fed8dc9e 100644 --- a/publication/publication.ptx +++ b/publication/publication.ptx @@ -2,7 +2,7 @@ - + From 5500e35f9eb891bb2a32415304d98d546252520e Mon Sep 17 00:00:00 2001 From: Andrew Scholer Date: Fri, 5 Dec 2025 11:31:57 -0800 Subject: [PATCH 2/2] LTI1p3 doc improvements Improve LTI1p3 course copy instructions Consolidate date syncing documentation Document no manual key exchange setup --- pretext/Registration/lti1p3.ptx | 98 +++++++++++++++++++++------------ 1 file changed, 64 insertions(+), 34 deletions(-) diff --git a/pretext/Registration/lti1p3.ptx b/pretext/Registration/lti1p3.ptx index 60d8b3db..1bc261dc 100644 --- a/pretext/Registration/lti1p3.ptx +++ b/pretext/Registration/lti1p3.ptx @@ -11,7 +11,7 @@

- Runestone's LTI 1.3 integration has been tested against Canvas and Moodle. Others LMS systems that support LTI 1.3 may or may not work. We welcome reports of successful use with other LMS systems and code pull requests to add any necessary support for other LMS systems. Community driven support is available on the #lti_community_support channel of the Runestone Discord Server. + Runestone's LTI 1.3 integration has been tested against Canvas, Moodle, and D2L. Others LMS systems that support LTI 1.3 may or may not work. We welcome reports of successful use with other LMS systems and code pull requests to add any necessary support for other LMS systems. Community driven support is available on the #lti_community_support channel of the Runestone Discord Server.

@@ -35,7 +35,7 @@

- Runestone supports the LTI Dynamic Registration protocol. This means you will just need to enter one URL into your LMS and the two systems will negotiate the rest of the details: + Runestone supports the LTI Dynamic Registration protocol. (We do not support manual registration of LTI 1.3 tools via manual key exchange.) This means you will just need to enter one URL into your LMS and the two systems will negotiate the rest of the details:

@@ -152,37 +152,39 @@ LTI1.3 Setup - Instructor - -

To use LTI 1.3 integration with a course, the domain of your LMS must be approved by a Runestone administrator. If your institution required Runestone to complete any paperwork as part of the setup of Runestone as an LTI 1.3 tool, this should already be complete. If your institution did not contact Runestone during setup, you will need to make a request for approval. You can do so by making a new issue on the Runestone github page. Select Request for LTI 1.3 Approval as the issue type and make sure to specify your contact information, and the domain your LMS runs on.

- - -

- First make sure that you have a Runestone account. If you don't have one, you can create one at Runestone Academy. Create a Runestone course to link to your LMS course. You may also wish to set up assignments in Runestone at this point, although you can always link new ones later. Before you try to link your LMS to a course and/or assignments, you should make sure you are logged into Runestone and currently viewing the course you want to link to. -

+ + +

To use LTI 1.3 integration with a course, the domain of your LMS must be approved by a Runestone administrator. If your institution required Runestone to complete any paperwork as part of the setup of Runestone as an LTI 1.3 tool, this should already be complete. If your institution did not contact Runestone during setup, you will need to make a request for approval. You can do so by making a new issue on the Runestone github page. Select Request for LTI 1.3 Approval as the issue type and make sure to specify your contact information, and the domain your LMS runs on.

+ -

- Depending on how your LMS reports your identity to Runestone, when you access Runestone from the LMS by clicking a link to your RS course or book, you may or may not be logged into Runestone as the same user as the account you created. (If your LMS reports your email, and you set up your RS account with the same email, then you should be logged in as the same user.) If you end up with a different identity in Runestone, you will likely want to add that user as an instructor. You can do this by adding the user as a TA. See for more information. -

+

+ First make sure that you have a Runestone account. If you don't have one, you can create one at Runestone Academy. Create a Runestone course to link to your LMS course. You may also wish to set up assignments in Runestone at this point, although you can always link new ones later. Before you try to link your LMS to a course and/or assignments, you should make sure you are logged into Runestone and currently viewing the course you want to link to. +

-

- Each RS course can be linked to only one LMS course. This means that if you have multiple courses in your LMS for multiple sections or some other reason, you will need to create different RS courses for each LMS course. You can link multiple RS courses to the same LMS course (if you are using multiple books in one course.) If you need to unlink Runestone from an LMS, you can use the Remote LTI 1.3 Association button from the Admin > LTI Integration screen. Doing so will NOT remove any assignments or grades from the LMS, but it will prevent new grades from being sent to the LMS. You can then relink the course with the same LMS course or a new one. -

- -

There are some settings available in each Runestone course that affect LTI integration: -

    -
  • Under Admin > Course Settings, Show Points in Gradebook will affect how scores are reported to the LMS. If you want assignments reported to the LMS as points (3 / 4) instead of percent (75%), make sure this is checked. Note that settings in your LMS grade book may allow you to weight scores or change their display in other ways that override the way Runestone reports them to the LMS.
    • -
  • Under Admin > LTI Integration, checking Ignore LTI1.3 Date Changes will prevent Runestone from updating due dates on assignments.
    • -
  • Under Admin > LTI Integration, checking Do not auto update LTI grades will prevent Runestone from trying to automatically send grade updates as a user completes activities. This may be desirable if your assignments contain lots of items that need to be hand graded and you do not want users to see misleading low grades for assignments that have not been fully scored yet.
    • -
-

+

+ Depending on how your LMS reports your identity to Runestone, when you access Runestone from the LMS by clicking a link to your RS course or book, you may or may not be logged into Runestone as the same user as the account you created. (If your LMS reports your email, and you set up your RS account with the same email, then you should be logged in as the same user.) If you end up with a different identity in Runestone, you will likely want to add that user as an instructor. You can do this by adding the user as a TA. See for more information. +

-

Find the subsection below for details on how to add Runestone to your course: +

+ Each RS course can be linked to only one LMS course. This means that if you have multiple courses in your LMS for multiple sections or some other reason, you will need to create different RS courses for each LMS course. You can link multiple RS courses to the same LMS course (if you are using multiple books in one course.) If you need to unlink Runestone from an LMS, you can use the Remote LTI 1.3 Association button from the Admin > LTI Integration screen. Doing so will NOT remove any assignments or grades from the LMS, but it will prevent new grades from being sent to the LMS. You can then relink the course with the same LMS course or a new one. +

+ +

There are some settings available in each Runestone course that affect LTI integration:

    -
    • -
    • -
    • +
  • Under Admin > Course Settings, Show Points in Gradebook will affect how scores are reported to the LMS. If you want assignments reported to the LMS as points (3 / 4) instead of percent (75%), make sure this is checked. Note that settings in your LMS grade book may allow you to weight scores or change their display in other ways that override the way Runestone reports them to the LMS.
    • +
  • Under Admin > LTI Integration, checking Ignore LTI1.3 Date Changes will prevent Runestone from updating due dates on assignments.
    • +
  • Under Admin > LTI Integration, checking Do not auto update LTI grades will prevent Runestone from trying to automatically send grade updates as a user completes activities. This may be desirable if your assignments contain lots of items that need to be hand graded and you do not want users to see misleading low grades for assignments that have not been fully scored yet.
-

+

+ +

Find the subsection below for details on how to add Runestone to your course: +

    +
    • +
    • +
    • +
+

+ LTI 1.3 Instructor Setup - Canvas @@ -272,8 +274,8 @@ - LTI1.3 Grade Reporting -

Grades are normally sent to Runestone at the following times: + Grade Reporting +

Grades are normally sent by Runestone to the LMS at the following times:

  • A learner interacts with any graded element of the course that is part of an active assignment with released grades. (Grade updates should happen whether the user is viewing the problem in context or in the assignment view).
  • The instructor goes to the Grading tab of the admin interface, selects an assignment and presses the Push Grades to LTI button. This will send score updates for that assignment for all users in the course regardless of whether or not scores are released in Runestone.
    • @@ -283,30 +285,58 @@

    + + Date Syncing +

    Your LMS is considered the authority on due dates. By default, Runestone assignments will update their due dates to match the LMS. To disable this behavior, you can check the Ignore LTI1.3 Date Changes box in the Admin > LTI Integration settings for your course. (Automatically syncing from Runestone to the LMS is not an option.)

    +

    Syncing behavior: +

      +
    • When you create a new assignment in your LMS by linking to a Runestone assignment, the due date in your LMS will be set to the due date in Runestone.
      • +
    • When linking an existing LMS assignment to a Runestone assignment, the due date in Runestone will be updated to match the due date in the LMS (unless you have checked the Ignore LTI1.3 Date Changes).
      • +
    • When an assignment's due date is changed in the LMS, the due date in Runestone will be updated to match (unless you have checked the Ignore LTI1.3 Date Changes). This will not happen until a user (instructor or student) uses the assignment link in the LMS to launch the assignment in Runestone. So, to force an update after modifying a due date, open the assignment.
      • +
    +

    +     + Copying an LTI1.3 Course

    To reuse course content that you linked in one course for a new course, you will generally want to do the following:

    1. - Use your LMS to copy the assignments from your old course to your new course. They will not be linked to Runestone. If you want to synchronize the due dates automatically, use your LMS to set up due dates. + Use your LMS to copy the assignments from your old course to your new course. They will not be linked to Runestone.
    2. In Runestone, make a new course. Copy all of the assignments from your old course to your new course. If you want to make sure the due dates are synced, do not check the Ignore LTI1.3 Date Changes box in the Admin > LTI Integration settings for your new course before finishing the linking process.
      3. +

    3. + Do you want to have due dates in Runestone set to match those in your LMS for the copied assignments? +

        +
      • +

        If Yes, make sure the Ignore LTI1.3 Date Changes is not checked. (Should be the default)

        +

        Then, set up due dates in the LMS before linking the assignments.

        +
        • +
      • If No, check the Ignore LTI1.3 Date Changes box in the Admin > LTI Integration settings for your new course.
        • +
      +

      +
      4. +
    4. + Assignments in Runestone and the LMS will be matched by name. If the assignment names do not match, change the name(s) on either platform so corresponding assignments are identically named. +
    5. - In your LMS, use the add content feature and select the Runestone tool. Assuming your assignments in the two platforms have matching names, the default actions suggested for each RS assignment will be to link to the existing LMS assignment with the same name. If there is a mismatch, change the LMS assignment name to match the RS assignment name before linking. When you submit the form, the assignments will be linked and the due dates from the LMS will be synced to Runestone. +

      Now you are ready to link the copies on the two platforms. Make sure you are still logged into the new course in Runestone as you complete the linking.

      +

      In your LMS, use the add content feature and select the Runestone tool. Assuming your assignments in the two platforms have matching names, the default actions suggested for each RS assignment will be to link to the existing LMS assignment with the same name.

      +

      Submit the form to complete the linking process. You may get a message like Tool returned no content as there were no new assignments sent from Runestone back to the LMS. But, the selected assignments should now be linked. Click one to verify.

     - LTI 1.3 Canvas Notes + Canvas Notes for LTI 1.3

    The best way to create new content items (especially multiple at one time) is in the Modules area. Use the three dot menu and select Runestone.

    Adding Runestone items from the Canvas Module area     - LTI 1.3 Moodle Notes + Moodle Notes for LTI 1.3

    To add content items, use one of the Add an activity or resource links in your course. Select Runestone from the available tools. You will be taken to a form adding one activity, but you can still add as many Runestone links as you like. Click the Select content button. When you finish selecting content, if you selected just one new RS item, you will return to the form to finish editing that activity and save it in your LMS. If you selected multiple items, you will return to a page that lists the items being added. If your actions do not add any new content (you are remapping copied assignments), you will be returned to a blank form but Runestone will have updated your selected items.

    Adding Runestone items from the Moodle Select content area