CAPP - Practice Content Guidelines -

Partners

Version 1.0
April 2020

1
 Table of Contents

1. Introduction ......................................................................................3
1.1 CAPP requirement ............................................................................................ 3
1.2 Overview of the Solution structure in Varafy ................................................... 4

2. Process flow in Varafy........................................................................6

2.1. Procedure to create a question block ............................................................... 6
2.2. Procedure to create a solution block ................................................................ 8
2.3. Procedure to create Variables ........................................................................ 11
2.4. Procedure to create Number Type variable .................................................... 12
2.5. Procedure to create Function Type variable ................................................... 14
2.6. Procedure to create List Type variable ........................................................... 15
2.7. Procedure to create Date Type variable ......................................................... 17
2.8. Instructions to add Meta data fields.....………………………………………………………. 18

3. Content creation process for Authoring ............................................ 20

4. Content creation process for Re-Authoring ....................................... 22
5. Notable points………………………………………………………………………………… 24

2
 1. Introduction
Chegg Assessment and Proficiency Platform (CAPP) is a new program to address the need for
students to assess their preparedness for a test/exam/quiz. This practice problems would be
helpful to prepare them for the respective course test/exam/quiz.

1.1 CAPP Requirement

Expert should author the content in the recommend structure on Varafy tool. Expert need to
create certain number of unique problems for a given topic of the given course. From each topic
of a selected course, IH expert will create sets with the recommended number of problems once
they completed QA (Quality Assurance).

Problem name convention:

The name of the set should be in the below format: Subject_Course_DL_QT_ST_ITEMID_SOURCE

Detailed description is provided below:

SUBJECT: Name of the subject for which a specified course name is given

COURSE: The name of the course given for the subject

DL: The difficulty level of the question (Example: 01/02/03/04/05) to be created

QT: Question type (MCQ or T/F or Blank(s)) (Currently, use MCQ type only)

ST: Scoring type (It is a numerical number going to provide during assessment) (Currently, use 03)

ITEMID: It is the name of the item (It is a numerical number starting from 1)

SOURCE: Source is SPI

BACK

3
1.2 Overview of the solution structure in Varafy
Keywords in Problem

General guidance

The first section of the solution should begin with ‘General guidance’. General guidance includes
‘Concepts and reason’ and ‘Fundamentals’ related to the question. The purpose of giving this
information is to guide the student to understand the question before solving it.

Concepts and reason

• Expert should provide concepts related to the question and the approach to follow to guide
the student in the right path of solving.
• The concepts include related statements, theorems, etc. The expert should also mention the
reason for following certain concepts to solve the question.
Fundamentals

Expert should re-iterate the following points

• Basic definitions or key points that are necessary to understand the concept(s).
• Rules with their description
• Necessary formulae
• Explanation of variables in the formula
Starting Hint

• In this section, expert should provide a necessary hint to initiate the first step of the solution
in one or two sentences.
• Expert should also talk about the end-result of the first step.
For example, “To calculate the end values of variables, first take the partial derivatives of the
function.”

Step 1

The first step of the solution begins here.

• Every step has Explanation, Common mistakes, and Hint for next step.
• Explanation is mandatory for every step. A step without explanation is not acceptable.
Common mistakes and Hint for next step are also mandatory for each step in the solution.

BACK
4
Explanation

Here, the expert should give detailed explanation pertaining to the step. If a formula is used in the
step, the expert should give all the necessary explanation related to it.

Common mistakes

• The expert should caution the student of the possible mistakes (with proper reason) that are
prone in the step.
i
Example: Do not use the relation V = to calculate the voltage. It is a mistake because the correct
R
formula is V = iR .

• The expert should also provide key points to remember while doing the step in this section.
Hint for next step

Here, the expert should provide a necessary hint about the general idea in the next step or outcome
of the next step in one or two sentences.

Example: Use Ohm’s law to find the resistance R.

General idea: Using Ohm’s Law

Outcome of the next step: Calculating Resistance R

Step 2

• The second step of the solution begins here.

• Every solution must include more than one step.
• The procedure mentioned in the first step should be followed here and in the remaining
steps as well.
Note: Keywords in solution structure that need to be tagged in Varafy

BACK

5
 2. Process flow in Varafy
The process of creation of practice problem on Varafy is illustrated below with screenshots:

• Go to https://app.varafy.com/login page and Log In with your credentials

• After validation, it navigates to the Varafy Dashboard shown below:

2.1 Procedure to create a question block

• Click on ‘+Add a new block to Question’ option to add required blocks in question window.

• Every question block should have text/image/math/graph related question with ‘Multiple
Choice’ assessment block.
BACK

6
 • Every ‘Multiple Choice’ assessment block should have 1 correct option and 3 wrong options.
• Provide correct answer details in “Answer Pool”
• Provide wrong answer details in “Distractor Pool”
• Click on ‘Add new Distractor’ to add wrong answers one by one.
• Choose Sorting Method as Random.
• Select Style as a, b, c, d . . .

Note: Do not use any tags in question block.

BACK
7
2.2 Procedure to create a solution block
• Solution should be provided in the “Solution” block only.
• The relevant keyword tags should be tagged to the respective blocks.
• Click on tag option to add required tags to respective blocks.

• Click on ‘+Add a new block to solution’ option to add required blocks in solution window.

• Use Step by Step structure block for step by step solution.

• Every solution should have minimum two steps.

Stage-1:

• Add text/image/math/graph/other block, change the block name as “General Guidance”, and
add ‘generalGuidance’ tag.

• The “General Guidance” block should have information about ‘Concepts and reason’ &
‘Fundamentals’
• ‘Concepts and reason’ & ‘Fundamentals’ headings should be bold. Do not underline. Do not use
colon, semicolon, etc. at the end of the headings - ‘Concepts and reason’ & ‘Fundamentals’
• In case there are more than one block usage for General guidance, please add generalGuidance
tag to all blocks.

BACK

8
Stage-2:

• Add text/image/math/graph/other block, change the block name as “Starting hint”, and add
hint tag.

Stage-3:

• Click on ‘Add a new block to solution’ and ‘Add a new block to Step by Step’ from Structure tab
in the blocks window.

• Click on ‘Add a new block to Step by Step’ and ‘Add required text/image/math/graph/other
blocks’. BACK

9
 • Every step should have Explanation, Common mistakes, and Hint for next step.
• For explanation, change the block names as “Explanation” and add explanation tag.

• In case there are more than one block usage for explanation, please add explanation tag to all
blocks.
• For Common Mistakes, change the block names as “Common Mistakes” and add
commonMistake tag.

Note: If common mistakes are not available, do not add common mistakes block and commonMistake
tag.

For Hint for next Step, change the block names as “Hint for next Step” and add hintForNextStep tag.

Note: If Hint for next Step is not available, do not add Hint for next Step block and hintForNextStep tag.

BACK
10
Stage-4:

• Click on Add a Step and repeat Stage-3 for next steps.

• Tagging of ‘Hint for next Step’ block for the last step is not required.

2.3 Procedure to create Variables

• Variables are used in iterating the Question & Solution.
• To declare the variables, enter #_with_variable_name and click on Create.

• In another way, go to variables tab and create the required variables by clicking on + symbol.

• Currently 4 types of variables (Like, Number, Function, List and Date) are available in Varafy.

BACK

11
 • By default, it will create Number type variable.
• Based on the requirement, change the variable types.
• Use Clone option to create same format type variables with different names.

• Deactivate the variable by clicking on Θ Symbol.

• Power Editor helps to check preview of all declared variable values at a time and can manage
the variable as per the requirement.

2.4 Procedure to create Number Type variable

• To iterate the Question & Solution, maintain Minimum, Maximum and Increment value to all
used variables.

• To control the generated numbers, go to Edit Details and select required format from the
Round Type dropdown.

BACK

12
 • To control/add the units to generated numbers, go to Edit Details and select Unit.

• If required symbols/units are not available, go to Custom and enter respective unit/symbol Latex
code.

BACK

13
 • Click on Done button once the changes are completed.
• Make sure to use math-block or $$ $$ to appear customized Latex symbols or units.

2.5 Procedure to create Function Type variable

• Function Type variable helps to connect one variable with other variables.
• It supports all basic math operators.

• Go to help button (?) to know about other than basic math supported functions/commands.

BACK

14
 • Below is the screenshot of supported commands/functions.

• Click on Done button once the changes are completed.

2.6 Procedure to create List Type variable

List type variables act as an array function. This procedure helps to iterate the names/strings/required
numbers by adding the details in Add Item field.

BACK

15
• Click on Done button once the changes are completed.
• To control the multiple list Item indexes, use Index option.
• Based on Index value, call same index names/irregular-values for multiple list Items.

BACK
16
2.7 Procedure to create Date Type variable
• To iterate the dates in Question & Solution, enter Start Date, End Date, Increment, and
Increment Type fields to the variables.

• To change the date format, go to Edit Details and select required format from the Round Type
dropdown.

• Click on Done button once the changes are completed.

• Add constraints (if required) by clicking on +Add Constraint button
• Select variable and operator, and then enter value.

BACK

17
2.8 Instructions to add “Item Data” & “Meta Data” fields
• Experts should update all necessary “Item Data” and Meta data fields before creating an item.

Fields under “Item Data”:

• "Title” should be in the recommend problem name convention.

Example: Mathematics_Algebra_03_MC_04_33_SPI
• Update “Creator form” with “Question & Solution Template”
• Update “Keywords” with “Multiple choice” for Multiple Choice category problems
• “Difficulty Level” should be update as per problem difficulty level in the respective course

Fields under “Meta Data” (All fields are mandatory)

• Expert should enable all the fields by clicking on tick box to update the required details.

BACK

18
• The fields “Topic” & “Subject” should be updated from the dropdown or by using search
option.

BACK

19
 • “Question Type” field should be multiple choice for the multiple-choice problems.
• “Scoring Type” field should be 1 to 5 as per importance of the problem and expert should
use 5 for the most important problem in that topic.
• Update “Source” field with “Partner”
• Update “Creator” field with “User”
• “Status” field should be “Live”. In case, expert want to deactivate any item then they can
choose “Inactive” for “Status”.
• By default, “School”, “Course” & “Module” fields filled with “None”.
• “Exam” field should be “Exam” or “Midterm” as per recommendations IH team.

Note: IH team will inform to the sources if there are any changes in Meta data fields.

3. Content creation process for Authoring

• Go to ‘My Items’ tab and click on ‘Create a new Item’.

• Update Item Data and Meta Data fields.

• Make sure to choose ‘Create from’ field as ‘Question & Solution Template’ in Item Data fields,
tag the apt topic and choose the status as ‘Pending’ in Meta Data fields.
• Click on ‘Create’ button available at the bottom right corner.

20
 BACK

• After clicking on ‘Create’ button, it navigates to Varafy ‘Question & Solution Template’ page.

• Double click on refresh symbol ( ) to enable/disable the autosave option.

• Enable Autosave option to refresh and save the work after every 60 seconds.

• Click on Save ( ) button to save the work instantly.

• Click on Preview ( ) button to see the created ‘Question & Solution preview’.
• Click on Exit Preview button to exit the Preview Content page.
• Choose appropriate options to exit the Question & Solution Template page and submit the
created File/Item.

BACK

21
 • Proofread the content before clicking on ‘Submit for Review’ decision as it will not be available
for further editing and moves for Quality Assurance (to IH team).
• To open/edit the saved Item, please click on ‘Edit Item’ (→) button.

• To preview the saved Item, please click on ‘Preview Item’ button.

• To change the Folder Path, Item Data, Meta Data fields of the saved Item, please click on ‘Item
Details’ button.

4. Content creation process for Re-Authoring

The solution rejected in QA process is directed to re-authoring. The procedure for re-authoring is
explained below:

• Left-curved arrow ( ) on the Varafy Dashboard indicates the rejected / returned items.
• Open the item and rework as per the given feedback.

BACK
22
• Modify the content as per the reviewer’s feedback.

• To Edit/Delete/Resolve the comment, go to comments tab and take appropriate action.

• Repeat ‘Procedure for content creation’ to complete the reworked File/Item.

BACK

23
5. Notable points
• More helpful video tutorials are available in Varafy under bell icon ( ).
• Do not post any queries in Varafy “Help” window.
• Deleted item can never be recovered because there is no ‘recycle bin’ in Varafy.
• Do not click Hide option for any block.
• “ITEMID” will continue as a sequence order as per number of problems from a course.
• Extra care should be taken while dragging the blocks, if anything is wrong the entire block will be
disappear and not possible to restore it.
• At the end of Re-authoring, to ‘submit’ the file/item for review, make sure that all the
comments should be at ‘resolve’ stage.
• Constraints need to be used based on the question requirement.
• To Hide/Unhide the blocks header, go to Blocks tab and click on ‘Headers visible’ or ‘Headers
hidden’.

• Do not add any tags to ‘Question Window’ & “Solution” as well as question related Blocks.
• Add all keywords in solution structure should be tagged.
• Submitted file should be unique, free from plagiarism, and with good quality.
• The “General Guidance” block should have information about ‘Concepts and reason’ &
‘Fundamentals’.
• ‘Concepts and reason’ & ‘Fundamentals’ headings should be bold. Do not underline. Do not use
colon, semicolon, etc. at the end of the headings - ‘Concepts and reason’ & ‘Fundamentals’.
• To check plagiarism, download the pdf for the Item by clicking on Print then download options.

BACK

24