improved prompts for gpt-4o

src/prompts/slos/algorithmic_solutions_quant.md

@@ -26,12 +26,14 @@ Rubric:
 
    If the template includes `### Proficiency: ***`, the system will automatically assess the student as having met the Acceptable (3) level of proficiency.
 
-2. Your feedback MUST include a snippet from the student's submission and an example of how it should be improved. Students will not be engaged unless they receive concrete actionable feedback. You MUST ensure that your feedback is actionable and specific.
+2. Your feedback MUST include a snippet from the student's submission and an example of how it should be improved. Students will not be engaged unless they receive concrete actionable feedback. You MUST ensure that your feedback is actionable and specific. This snippet should only include relevant excerpts. For example, if commenting on a method's documentation comment, only include the documentation comment and the method signature, not the entire method.
 
 3. The snippets you include as described in the template must not be the entire submission, but rather a specific section of the submission that you are providing feedback on.
 
 4. Include as many snippets and feedback sections as you feel are necessary to provide a comprehensive review.
 
+5. Keep responses concise and appropriate as most students have short attention spans. Avoid lengthy explanations that may overwhelm them.
+
 ## Feedback template
 
 <!-- Template starts from here -->

src/prompts/slos/code_readability_written_com.md

@@ -55,12 +55,14 @@ In addition to the default formatters, you can find extensions on the Marketplac
 
    If the template includes `### Proficiency: ***`, the system will automatically assess the student as having met the Acceptable (3) level of proficiency.
 
-2. Your feedback MUST include a snippet from the student's submission and an example of how it should be improved. Students will not be engaged unless they receive concrete actionable feedback. You MUST ensure that your feedback is actionable and specific.
+2. Your feedback MUST include a snippet from the student's submission and an example of how it should be improved. Students will not be engaged unless they receive concrete actionable feedback. You MUST ensure that your feedback is actionable and specific. This snippet should only include relevant excerpts. For example, if commenting on a method's documentation comment, only include the documentation comment and the method signature, not the entire method.
 
 3. The snippets you include as described in the template must not be the entire submission, but rather a specific section of the submission that you are providing feedback on.
 
 4. Include as many snippets and feedback sections as you feel are necessary to provide a comprehensive review.
 
+5. Keep responses concise and appropriate as most students have short attention spans. Avoid lengthy explanations that may overwhelm them.
+
 ## Feedback template
 
 <!-- Template starts from here -->

src/prompts/slos/comments_written_com.md

@@ -26,12 +26,14 @@ Rubric:
 
    If the template includes `### Proficiency: ***`, the system will automatically assess the student as having met the Acceptable (3) level of proficiency.
 
-2. Your feedback MUST include a snippet from the student's submission and an example of how it should be improved. Students will not be engaged unless they receive concrete actionable feedback. You MUST ensure that your feedback is actionable and specific.
+2. Your feedback MUST include a snippet from the student's submission and an example of how it should be improved. Students will not be engaged unless they receive concrete actionable feedback. You MUST ensure that your feedback is actionable and specific. This snippet should only include relevant excerpts. For example, if commenting on a method's documentation comment, only include the documentation comment and the method signature, not the entire method.
 
 3. The snippets you include as described in the template must not be the entire submission, but rather a specific section of the submission that you are providing feedback on.
 
 4. Include as many snippets and feedback sections as you feel are necessary to provide a comprehensive review.
 
+5. Keep responses concise and appropriate as most students have short attention spans. Avoid lengthy explanations that may overwhelm them.
+
 ## Feedback template
 
 <!-- Template starts from here -->

src/prompts/slos/error_handling_verification.md

@@ -26,12 +26,14 @@ Rubric:
 
    If the template includes `### Proficiency: ***`, the system will automatically assess the student as having met the Acceptable (3) level of proficiency.
 
-2. Your feedback MUST include a snippet from the student's submission and an example of how it should be improved. Students will not be engaged unless they receive concrete actionable feedback. You MUST ensure that your feedback is actionable and specific.
+2. Your feedback MUST include a snippet from the student's submission and an example of how it should be improved. Students will not be engaged unless they receive concrete actionable feedback. You MUST ensure that your feedback is actionable and specific. This snippet should only include relevant excerpts. For example, if commenting on a method's documentation comment, only include the documentation comment and the method signature, not the entire method.
 
 3. The snippets you include as described in the template must not be the entire submission, but rather a specific section of the submission that you are providing feedback on.
 
 4. Include as many snippets and feedback sections as you feel are necessary to provide a comprehensive review.
 
+5. Keep responses concise and appropriate as most students have short attention spans. Avoid lengthy explanations that may overwhelm them.
+
 ## Feedback template
 
 <!-- Template starts from here -->

src/prompts/slos/logic_programming.md

@@ -26,12 +26,14 @@ Rubric:
 
    If the template includes `### Proficiency: ***`, the system will automatically assess the student as having met the Acceptable (3) level of proficiency.
 
-2. Your feedback MUST include a snippet from the student's submission and an example of how it should be improved. Students will not be engaged unless they receive concrete actionable feedback. You MUST ensure that your feedback is actionable and specific.
+2. Your feedback MUST include a snippet from the student's submission and an example of how it should be improved. Students will not be engaged unless they receive concrete actionable feedback. You MUST ensure that your feedback is actionable and specific. This snippet should only include relevant excerpts. For example, if commenting on a method's documentation comment, only include the documentation comment and the method signature, not the entire method.
 
 3. The snippets you include as described in the template must not be the entire submission, but rather a specific section of the submission that you are providing feedback on.
 
 4. Include as many snippets and feedback sections as you feel are necessary to provide a comprehensive review.
 
+5. Keep responses concise and appropriate as most students have short attention spans. Avoid lengthy explanations that may overwhelm them.
+
 ## Feedback template
 
 <!-- Template starts from here -->

src/prompts/slos/naming_written_com.md

@@ -26,12 +26,14 @@ Rubric:
 
    If the template includes `### Proficiency: ***`, the system will automatically assess the student as having met the Acceptable (3) level of proficiency.
 
-2. Your feedback MUST include a snippet from the student's submission and an example of how it should be improved. Students will not be engaged unless they receive concrete actionable feedback. You MUST ensure that your feedback is actionable and specific.
+2. Your feedback MUST include a snippet from the student's submission and an example of how it should be improved. Students will not be engaged unless they receive concrete actionable feedback. You MUST ensure that your feedback is actionable and specific. This snippet should only include relevant excerpts. For example, if commenting on a method's documentation comment, only include the documentation comment and the method signature, not the entire method.
 
 3. The snippets you include as described in the template must not be the entire submission, but rather a specific section of the submission that you are providing feedback on.
 
 4. Include as many snippets and feedback sections as you feel are necessary to provide a comprehensive review.
 
+5. Keep responses concise and appropriate as most students have short attention spans. Avoid lengthy explanations that may overwhelm them.
+
 ## Feedback template
 
 <!-- Template starts from here -->

src/prompts/slos/oop_programming.md

@@ -26,12 +26,14 @@ Rubric:
 
    If the template includes `### Proficiency: ***`, the system will automatically assess the student as having met the Acceptable (3) level of proficiency.
 
-2. Your feedback MUST include a snippet from the student's submission and an example of how it should be improved. Students will not be engaged unless they receive concrete actionable feedback. You MUST ensure that your feedback is actionable and specific.
+2. Your feedback MUST include a snippet from the student's submission and an example of how it should be improved. Students will not be engaged unless they receive concrete actionable feedback. You MUST ensure that your feedback is actionable and specific. This snippet should only include relevant excerpts. For example, if commenting on a method's documentation comment, only include the documentation comment and the method signature, not the entire method.
 
 3. The snippets you include as described in the template must not be the entire submission, but rather a specific section of the submission that you are providing feedback on.
 
 4. Include as many snippets and feedback sections as you feel are necessary to provide a comprehensive review.
 
+5. Keep responses concise and appropriate as most students have short attention spans. Avoid lengthy explanations that may overwhelm them.
+
 ## Feedback template
 
 <!-- Template starts from here -->

src/prompts/slos/syntax_programming.md

@@ -26,12 +26,14 @@ Rubric:
 
    If the template includes `### Proficiency: ***`, the system will automatically assess the student as having met the Acceptable (3) level of proficiency.
 
-2. Your feedback MUST include a snippet from the student's submission and an example of how it should be improved. Students will not be engaged unless they receive concrete actionable feedback. You MUST ensure that your feedback is actionable and specific.
+2. Your feedback MUST include a snippet from the student's submission and an example of how it should be improved. Students will not be engaged unless they receive concrete actionable feedback. You MUST ensure that your feedback is actionable and specific. This snippet should only include relevant excerpts. For example, if commenting on a method's documentation comment, only include the documentation comment and the method signature, not the entire method.
 
 3. The snippets you include as described in the template must not be the entire submission, but rather a specific section of the submission that you are providing feedback on.
 
 4. Include as many snippets and feedback sections as you feel are necessary to provide a comprehensive review.
 
+5. Keep responses concise and appropriate as most students have short attention spans. Avoid lengthy explanations that may overwhelm them.
+
 ## Feedback template
 
 <!-- Template starts from here -->

src/prompts/slos/testing_verification.md

@@ -26,12 +26,14 @@ Rubric:
 
    If the template includes `### Proficiency: ***`, the system will automatically assess the student as having met the Acceptable (3) level of proficiency.
 
-2. Your feedback MUST include a snippet from the student's submission and an example of how it should be improved. Students will not be engaged unless they receive concrete actionable feedback. You MUST ensure that your feedback is actionable and specific.
+2. Your feedback MUST include a snippet from the student's submission and an example of how it should be improved. Students will not be engaged unless they receive concrete actionable feedback. You MUST ensure that your feedback is actionable and specific. This snippet should only include relevant excerpts. For example, if commenting on a method's documentation comment, only include the documentation comment and the method signature, not the entire method.
 
 3. The snippets you include as described in the template must not be the entire submission, but rather a specific section of the submission that you are providing feedback on.
 
 4. Include as many snippets and feedback sections as you feel are necessary to provide a comprehensive review.
 
+5. Keep responses concise and appropriate as most students have short attention spans. Avoid lengthy explanations that may overwhelm them.
+
 ## Feedback template
 
 <!-- Template starts from here -->

src/prompts/system_message_outro.md

@@ -20,4 +20,4 @@
 3. Provide relevant examples or analogies to clarify complex concepts.
 4. Acknowledge students' efforts and progress, and motivate them to persevere.
 5. Be patient and empathetic; understand that students may be frustrated or confused.
-6. Keep responses concise and appropriate for students with short attention spans. Avoid lengthy explanations that may overwhelm them.
+6. Keep responses concise and appropriate as most students have short attention spans. Avoid lengthy explanations that may overwhelm them.