modified slo feedback template

src/prompts/slos/algorithmic_solutions_quant.md

@@ -14,11 +14,24 @@ Rubric:
 -
 - Beginner (1): Student does not demonstrate ability to select or use an algorithm to solve the problem.
 
-## Feedback template
+## Feedback Guidelines
+
+1. `number_of_stars` in the template must be formatted as described below. You absolutely MUST follow this template, as the system will look for these specific strings as shown below to determine the proficiency level for the student.
+
+   - Exemplary (5): `### Proficiency: *****`
+   - Accomplished (4): `### Proficiency: ****`
+   - Acceptable (3): `### Proficiency: ***`
+   - Needs Improvement (2): `### Proficiency: **`
+   - Beginner (1): `### Proficiency: *`
+
+   If the template includes `### Proficiency: ***`, the system will automatically assess the student as having met the Acceptable (3) level of proficiency.
+
+2. 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.
 
-> Note that feedback is to be shared as a valid Markdown file. The begining "```template " and the ending "``` " are not part of the feedback, but are used to denote the start and end of the template.
+3. Include as many snippets and feedback sections as you feel are necessary to provide a comprehensive review.
+
+## Feedback template
 
-```template
 ## Algorithmic Solutions - {{ Feedback_title }}
 
 {{ Snippet_from_submission_1 }}
@@ -39,14 +52,3 @@ Rubric:
 ### Proficiency: {{ number_of_stars }}
 
 {{ tips_and_suggestions_to_improve }}
-```
-
-`number_of_stars` here must be formatted as `***` for Acceptable (3). You absolutely MUST follow this template, as the system will look for these specific strings as shown below to determine the proficiency level for the student.
-
-- Exemplary (5): `### Proficiency: *****`
-- Accomplished (4): `### Proficiency: ****`
-- Acceptable (3): `### Proficiency: ***`
-- Needs Improvement (2): `### Proficiency: **`
-- Beginner (1): `### Proficiency: *`
-
-If the template includes `### Proficiency: ***`, the system will automatically assess the student as having met the Acceptable (3) level of proficiency.

src/prompts/slos/code_readability_written_com.md

@@ -42,11 +42,24 @@ Along with manually invoking code formatting, you can also trigger formatting ba
 
 In addition to the default formatters, you can find extensions on the Marketplace to support other languages or formatting tools. There is a `Formatters` category so you can easily search and find [formatting extensions](https://marketplace.visualstudio.com/search?target=VSCode&category=Formatters&sortBy=Installs). In the **Extensions** view search box, type 'formatters' or 'category:formatters' to see a filtered list of extensions within VS Code.
 
-## Feedback template
+## Feedback Guidelines
+
+1. `number_of_stars` in the template must be formatted as described below. You absolutely MUST follow this template, as the system will look for these specific strings as shown below to determine the proficiency level for the student.
+
+   - Exemplary (5): `### Proficiency: *****`
+   - Accomplished (4): `### Proficiency: ****`
+   - Acceptable (3): `### Proficiency: ***`
+   - Needs Improvement (2): `### Proficiency: **`
+   - Beginner (1): `### Proficiency: *`
 
-> Note that feedback is to be shared as a valid Markdown file. The begining "```template " and the ending "``` " are not part of the feedback, but are used to denote the start and end of the template.
+   If the template includes `### Proficiency: ***`, the system will automatically assess the student as having met the Acceptable (3) level of proficiency.
+
+2. 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.
+
+3. Include as many snippets and feedback sections as you feel are necessary to provide a comprehensive review.
+
+## Feedback template
 
-```template
 ## Code Readability and Formatting - {{ Feedback_title }}
 
 {{ Snippet_from_submission_1 }}
@@ -67,14 +80,3 @@ In addition to the default formatters, you can find extensions on the Marketplac
 ### Proficiency: {{ number_of_stars }}
 
 {{ tips_and_suggestions_to_improve }}
-```
-
-`number_of_stars` here must be formatted as `***` for Acceptable (3). You absolutely MUST follow this template, as the system will look for these specific strings as shown below to determine the proficiency level for the student.
-
-- Exemplary (5): `### Proficiency: *****`
-- Accomplished (4): `### Proficiency: ****`
-- Acceptable (3): `### Proficiency: ***`
-- Needs Improvement (2): `### Proficiency: **`
-- Beginner (1): `### Proficiency: *`
-
-If the template includes `### Proficiency: ***`, the system will automatically assess the student as having met the Acceptable (3) level of proficiency.

src/prompts/slos/comments_written_com.md

@@ -16,11 +16,6 @@ Rubric:
 
 - Beginner (1): Program does not include clear and meaningful comments.
 
-## Feedback template
-
-> Note that feedback is to be shared as a valid Markdown file. The begining "```template " and the ending "``` " are not part of the feedback, but are used to denote the start and end of the template.
-
-```template
 ## Comments and Documentation - {{ Feedback_title }}
 
 {{ Snippet_from_submission_1 }}
@@ -41,14 +36,3 @@ Rubric:
 ### Proficiency: {{ number_of_stars }}
 
 {{ tips_and_suggestions_to_improve }}
-```
-
-`number_of_stars` here must be formatted as `***` for Acceptable (3). You absolutely MUST follow this template, as the system will look for these specific strings as shown below to determine the proficiency level for the student.
-
-- Exemplary (5): `### Proficiency: *****`
-- Accomplished (4): `### Proficiency: ****`
-- Acceptable (3): `### Proficiency: ***`
-- Needs Improvement (2): `### Proficiency: **`
-- Beginner (1): `### Proficiency: *`
-
-If the template includes `### Proficiency: ***`, the system will automatically assess the student as having met the Acceptable (3) level of proficiency.

src/prompts/slos/error_handling_verification.md

@@ -14,11 +14,6 @@ Rubric:
 
 - Beginner (1): Program does not show evidence of input validation or error handling.
 
-## Feedback template
-
-> Note that feedback is to be shared as a valid Markdown file. The begining "```template " and the ending "``` " are not part of the feedback, but are used to denote the start and end of the template.
-
-```template
 ## Error Handling - {{ Feedback_title }}
 
 {{ Snippet_from_submission_1 }}
@@ -39,14 +34,3 @@ Rubric:
 ### Proficiency: {{ number_of_stars }}
 
 {{ tips_and_suggestions_to_improve }}
-```
-
-`number_of_stars` here must be formatted as `***` for Acceptable (3). You absolutely MUST follow this template, as the system will look for these specific strings as shown below to determine the proficiency level for the student.
-
-- Exemplary (5): `### Proficiency: *****`
-- Accomplished (4): `### Proficiency: ****`
-- Acceptable (3): `### Proficiency: ***`
-- Needs Improvement (2): `### Proficiency: **`
-- Beginner (1): `### Proficiency: *`
-
-If the template includes `### Proficiency: ***`, the system will automatically assess the student as having met the Acceptable (3) level of proficiency.

src/prompts/slos/logic_programming.md

@@ -14,11 +14,24 @@ Rubric:
 
 - Beginner (1): The program's logic is severely flawed (e.g., the chosen control structures impede the functionality and understandability of the code, program's flow is disjointed or non-functional).
 
-## Feedback template
+## Feedback Guidelines
+
+1. `number_of_stars` in the template must be formatted as described below. You absolutely MUST follow this template, as the system will look for these specific strings as shown below to determine the proficiency level for the student.
+
+   - Exemplary (5): `### Proficiency: *****`
+   - Accomplished (4): `### Proficiency: ****`
+   - Acceptable (3): `### Proficiency: ***`
+   - Needs Improvement (2): `### Proficiency: **`
+   - Beginner (1): `### Proficiency: *`
+
+   If the template includes `### Proficiency: ***`, the system will automatically assess the student as having met the Acceptable (3) level of proficiency.
+
+2. 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.
 
-> Note that feedback is to be shared as a valid Markdown file. The begining "```template " and the ending "``` " are not part of the feedback, but are used to denote the start and end of the template.
+3. Include as many snippets and feedback sections as you feel are necessary to provide a comprehensive review.
+
+## Feedback template
 
-```template
 ## Logic - {{ Feedback_title }}
 
 {{ Snippet_from_submission_1 }}
@@ -39,14 +52,3 @@ Rubric:
 ### Proficiency: {{ number_of_stars }}
 
 {{ tips_and_suggestions_to_improve }}
-```
-
-`number_of_stars` here must be formatted as `***` for Acceptable (3). You absolutely MUST follow this template, as the system will look for these specific strings as shown below to determine the proficiency level for the student.
-
-- Exemplary (5): `### Proficiency: *****`
-- Accomplished (4): `### Proficiency: ****`
-- Acceptable (3): `### Proficiency: ***`
-- Needs Improvement (2): `### Proficiency: **`
-- Beginner (1): `### Proficiency: *`
-
-If the template includes `### Proficiency: ***`, the system will automatically assess the student as having met the Acceptable (3) level of proficiency.

src/prompts/slos/naming_written_com.md

@@ -14,11 +14,6 @@ Rubric:
 
 - Beginner (1): Variable, function, and object names are not meaningful or consistent and do not follow standard language conventions.
 
-## Feedback template
-
-> Note that feedback is to be shared as a valid Markdown file. The begining "```template " and the ending "``` " are not part of the feedback, but are used to denote the start and end of the template.
-
-```template
 ## Naming Conventions - {{ Feedback_title }}
 
 {{ Snippet_from_submission_1 }}
@@ -39,14 +34,3 @@ Rubric:
 ### Proficiency: {{ number_of_stars }}
 
 {{ tips_and_suggestions_to_improve }}
-```
-
-`number_of_stars` here must be formatted as `***` for Acceptable (3). You absolutely MUST follow this template, as the system will look for these specific strings as shown below to determine the proficiency level for the student.
-
-- Exemplary (5): `### Proficiency: *****`
-- Accomplished (4): `### Proficiency: ****`
-- Acceptable (3): `### Proficiency: ***`
-- Needs Improvement (2): `### Proficiency: **`
-- Beginner (1): `### Proficiency: *`
-
-If the template includes `### Proficiency: ***`, the system will automatically assess the student as having met the Acceptable (3) level of proficiency.

src/prompts/slos/oop_programming.md

@@ -14,11 +14,6 @@ Rubric:
 
 - Beginner (1): Program does not demonstrate a grasp of object-oriented principles, and the code lacks any meaningful application of abstraction, encapsulation, inheritance, or polymorphism.
 
-## Feedback template
-
-> Note that feedback is to be shared as a valid Markdown file. The begining "```template " and the ending "``` " are not part of the feedback, but are used to denote the start and end of the template.
-
-```template
 ## Object-Oriented Programming - {{ Feedback_title }}
 
 {{ Snippet_from_submission_1 }}
@@ -39,14 +34,3 @@ Rubric:
 ### Proficiency: {{ number_of_stars }}
 
 {{ tips_and_suggestions_to_improve }}
-```
-
-`number_of_stars` here must be formatted as `***` for Acceptable (3). You absolutely MUST follow this template, as the system will look for these specific strings as shown below to determine the proficiency level for the student.
-
-- Exemplary (5): `### Proficiency: *****`
-- Accomplished (4): `### Proficiency: ****`
-- Acceptable (3): `### Proficiency: ***`
-- Needs Improvement (2): `### Proficiency: **`
-- Beginner (1): `### Proficiency: *`
-
-If the template includes `### Proficiency: ***`, the system will automatically assess the student as having met the Acceptable (3) level of proficiency.

src/prompts/slos/syntax_programming.md

@@ -14,11 +14,24 @@ Rubric:
 
 - Beginner (1): Program does not compile/run successfully due to widespread use of invalid syntax, making it very hard to understand the student's intent.
 
-## Feedback template
+## Feedback Guidelines
+
+1. `number_of_stars` in the template must be formatted as described below. You absolutely MUST follow this template, as the system will look for these specific strings as shown below to determine the proficiency level for the student.
+
+   - Exemplary (5): `### Proficiency: *****`
+   - Accomplished (4): `### Proficiency: ****`
+   - Acceptable (3): `### Proficiency: ***`
+   - Needs Improvement (2): `### Proficiency: **`
+   - Beginner (1): `### Proficiency: *`
+
+   If the template includes `### Proficiency: ***`, the system will automatically assess the student as having met the Acceptable (3) level of proficiency.
+
+2. 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.
 
-> Note that feedback is to be shared as a valid Markdown file. The begining "```template " and the ending "``` " are not part of the feedback, but are used to denote the start and end of the template.
+3. Include as many snippets and feedback sections as you feel are necessary to provide a comprehensive review.
+
+## Feedback template
 
-```template
 ## Syntax - {{ Feedback_title }}
 
 {{ Snippet_from_submission_1 }}
@@ -39,14 +52,3 @@ Rubric:
 ### Proficiency: {{ number_of_stars }}
 
 {{ tips_and_suggestions_to_improve }}
-```
-
-`number_of_stars` here must be formatted as `***` for Acceptable (3). You absolutely MUST follow this template, as the system will look for these specific strings as shown below to determine the proficiency level for the student.
-
-- Exemplary (5): `### Proficiency: *****`
-- Accomplished (4): `### Proficiency: ****`
-- Acceptable (3): `### Proficiency: ***`
-- Needs Improvement (2): `### Proficiency: **`
-- Beginner (1): `### Proficiency: *`
-
-If the template includes `### Proficiency: ***`, the system will automatically assess the student as having met the Acceptable (3) level of proficiency.

src/prompts/slos/testing_verification.md

@@ -14,11 +14,24 @@ Rubric:
 
 - Beginner (1): Student did not show evidence of testing.
 
-## Feedback template
+## Feedback Guidelines
+
+1. `number_of_stars` in the template must be formatted as described below. You absolutely MUST follow this template, as the system will look for these specific strings as shown below to determine the proficiency level for the student.
+
+   - Exemplary (5): `### Proficiency: *****`
+   - Accomplished (4): `### Proficiency: ****`
+   - Acceptable (3): `### Proficiency: ***`
+   - Needs Improvement (2): `### Proficiency: **`
+   - Beginner (1): `### Proficiency: *`
+
+   If the template includes `### Proficiency: ***`, the system will automatically assess the student as having met the Acceptable (3) level of proficiency.
+
+2. 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.
 
-> Note that feedback is to be shared as a valid Markdown file. The begining "```template " and the ending "``` " are not part of the feedback, but are used to denote the start and end of the template.
+3. Include as many snippets and feedback sections as you feel are necessary to provide a comprehensive review.
+
+## Feedback template
 
-```template
 ## Testing - {{ Feedback_title }}
 
 {{ Snippet_from_submission_1 }}
@@ -39,14 +52,3 @@ Rubric:
 ### Proficiency: {{ number_of_stars }}
 
 {{ tips_and_suggestions_to_improve }}
-```
-
-`number_of_stars` here must be formatted as `***` for Acceptable (3). You absolutely MUST follow this template, as the system will look for these specific strings as shown below to determine the proficiency level for the student.
-
-- Exemplary (5): `### Proficiency: *****`
-- Accomplished (4): `### Proficiency: ****`
-- Acceptable (3): `### Proficiency: ***`
-- Needs Improvement (2): `### Proficiency: **`
-- Beginner (1): `### Proficiency: *`
-
-If the template includes `### Proficiency: ***`, the system will automatically assess the student as having met the Acceptable (3) level of proficiency.