Free Text¶
Free text assessments allow students to answer questions in their own words. Because Free Text assessments allow for LaTeX formatting, this type of assessment is recommended for math assessments. Teachers are then able to review and manually grade their answers.
Assessment Auto-Generation¶
Assessments can be auto-generated using the text on the current guides page as context. Follow the steps below to auto-generate a Free Text assessment:
Select Free Text assessment from Assessments list.
Press the Generate button at bottom right corner.
The Generation Prompt will open, press Generate Using AI to preview the generated assessment.
If you are not satisfied with the result, select Regenerate to create a new version of the assessment. You can provide additional guidance in the Generation Prompt field. For example, create assessment based on the first paragraph with 2 correct answers.
When you are satisfied with the result, press Apply and then Create.
More information about generating assessments may be found on the AI assessment generation page.
Assessment Manual Creation¶
Follow these steps to set up a free text assessment manually:
On the General page, enter the following information:
Name - Enter a short name that describes the test. This name is displayed in the teacher dashboard so the name should reflect the challenge and thereby be clear when reviewing.
If you want to hide the name in the challenge text the student sees, toggle the Show Name setting to disable it.
Instruction - Enter the instructions in markdown to be shown to the students.
Click Grading in the navigation pane and complete the following fields:
Points - Enter the score for correctly answering the question. You can choose any positive numeric value. If this is an ungraded assessment, enter zero (0).
Allow Partial Points - Toggle to enable a percentage of total points to be given based on the percentage of answers they correctly answer. Once you toggle this on, you will be able to add rubric items. Rubric items are negative points, they will be subtracted from the total score of the assessment.
Preview Type - Choose the input (plaintext or markdown) to be provided by the student. LaTex is also supported and is useful when students need to enter mathematical formulas in their answers. The following options are available:
Plaintext - Students enter ordinary text with no markdown formatting; there is no preview window.
Plaintext + LaTeX - Students enter plaintext with no markdown formatting but offers support for LaTeX commands. A preview window is available where students can see the rendered LaTeX output.
Markdown + LaTeX - Students enter markdown that also offers support for LaTex commands. A preview window is available where students can see the rendered markdown with LaTeX output.
Define Number of Attempts - enable to allow and set the number of attempts students can make for this assessment. If disabled, the student can make unlimited attempts.
Show Rationale to Students - Toggle to display the rationale for the answer, to the student. This guidance information will be shown to students after they have submitted their answer and any time they view the assignment after marking it as completed. You can set when to show this selecting from Never, After x attempts, If score is greater than or equal to a % of the total or Always
Rationale - Enter guidance for the assessment. This is visible to the teacher when the project is opened in the course or when opening the student’s project. This guidance information can also be shown to students after they have submitted their answer and when they reload the assignment after marking it as completed.
Click on the Parameters tab if you wish to edit/change Parameterized Assessments (deprecated) using a script. See Parameterized Assessments for more information. New parameterized assessments can no longer be set up.
Click Metadata in the left navigation pane and complete the following fields:
Bloom’s Level - Click the drop-down and choose the level of Bloom’s Taxonomy: https://cft.vanderbilt.edu/guides-sub-pages/blooms-taxonomy/ for the current assessment.
Learning Objectives specific educational goal of the current assessment. Typically, objectives begin with Students Will Be Able To (SWBAT). For example, if an assessment asks the student to predict the output of a recursive code segment, then its Learning Objectives could be SWBAT follow the flow of recursive execution.
Tags - By default, Content and Programming Language tags are provided and required. To add another tag, click Add Tag and enter the name and values.
Click Files in the left navigation pane and check the check boxes for additional external files to be included with the assessment. The files are then included in the Additional content list.
Click Create to complete the process.
Grading free text assessments¶
To review and grade answers given by students in a free text assessment, follow these steps:
Select the assignment to view the list of all assessments in the assignment for the student.
You can identify the free text assessments by the following icon in the Type column:
Click any line to view the question and the answer submitted by the student.
In the Points for answer field, perform one of the following depending on whether Allow Partial Points was enabled or disabled for the question:
If Allow Partial Points was disabled, click Correct or Incorrect:
If Allow Partial Points was enabled, select the points to give for the answer up to the maximum points:
In the Comments field, enter any information (in markdown + LaTeX) about the grade, which can be viewed by the student when the grade is released, and then click Submit Comment.
View graded free text assessments¶
You can view the points given and the Correct column checked for all free text assessments that have been graded.
Free text assessments that are automatically graded as correct¶
You can do this with Free Text Autograde.