To use the Edit questions procedure, there are several steps to follow.
First, change Language of work to the language in which you will be writing if it is not the one shown.
Second, click on course for the course you will be working on. This will open the first question of the first chapter of the course selected.
Third, click on Chapter for the chapter wanted.
Fourth, write, edit or translate the text in the TEXTAREA keeping in mind the recommendations indicated above; verify that the answer shown in the answer box is correct and that the anchor and concept match.
Fifth, save the question,
Sixth, after all questions have are done, click on "Notify work completed".

Layout of the screen

The full screen of the Edit questions procedure is divided in several parts:
- the upper yellow shaded part identifies the material selected and allows to move to another selection; buttons are present in this part to show the corresponding question in English (if the text is a translation of an English question) or to show the entire questions file instead of the text of the chapter; to see what resources can be used in questions, checkmarks are provide for List audio, case, images, tables, pdf or othe documents; this part also offers the possibility to change the question type, graph, answer, anchor and concept, which in most cases you should NOT change;
- right below it, is the TEXTAREA where appears the plain text of the question selected, and that is where all the writing, editing or translating work is to be performed; just below the TEXTAREA several buttons are presented to perform different steps;
- below the yellow shaded area, a "Preview question" presents the text of the questions, the resources (graph, table, audio or document) used in the question, the correct answer and a button linking a widow with the concept where the questions is explained; the possible answers of multiple choice questions are reshuffled exactly as they will be in grade tests in which the question is used;
- further below the yellow shaded area, a "Preview box" shows the entire contents of a given chapter test questions if the "Show questions" button was clicked;
- even further below the yellow shaded area, a "Preview box" presents the text of the chapter to which the questions pertain, with the anchors appearing in red and a highlight on the anchor for the question shown; note that the text appears as it will for students in their browsers, except that the images are missing and the links do not function;
- a "Work status" schedule shows the ID numbers of those who worked on the different questions files for that course;
a colour scheme in the schedule (see below) indicates the status of all the sections in the course:
- at the very bottom of the screen, these explanations are provided;
- in between these parts, various small messages may appear to indicate the actual name of the file saved or retrieved, the name of the person to whom the corresponding task is assigned or who last worked on the material selected, and a list of anchors not matching in the text (if any), as well as the resources that were selected to be listed.

Colour code in "Work status schedule"

The background of a section is

- white if there is no page of that type of section in this courses;

- light grey or light yellow if the page exists, but no task has been set up for this page;

- light green if a task exists for this page, but no volunteer has chosen this page as a task;

- pink if the volunteer has chosen this page as a task, but has not yet worked on it;

- dark grey if the volunteer has added or corrected material in the page;

- dark blue if the volunteer has clicked on the button to "Notify works completed";

- black if all work on this page is completed and the page has been moved to the permanent folder;

(note that records may not be up-to-date for all the work done, especially for materials inserted prior to the installation of the task monitoring system);

Selection of task

If a task exists for the currently opened section page, this is indicated in a line just above the yellow shaded box at the top of the screen. If the task has not been selected, a button will appear, that allows to select that task. For then on, the button will no longer appear, and the colour in the "Work schedule" will be pink rather than light green. The deadline is initially set to two weeks from the date selected. The deadline can be changed in "My tasts selection" or "My work".

Recommendations on how to write questions

As previously indicated, all the work to be performed is in the TEXTAREA. It is advisable not to erase or damage the structure of the question. It is possible to copy and paste any portion of the question in the TEXTAREA. But the material pasted must be in text format with line breaks. Pasting material copied directly from a word processor in another format than plain text is likely to result in a corrupted file and an error message.

These questions are test questions which are retrieved randomly when a student takes a test. They differ significantly from the practice questions in their format (although, naturally, they cover the same material and may even contain identical wording). Whereas practice question are plain HTML pages, test questions files are text files with very rigid parameters. The reason for the rigid structure is that each multiple choice question is restructured each time it is used. Also, for fill-in type questions and for calculation questions, this permits more than one possible answer whenever that is necessary. Finally, there are graphic questions that are also rearranged so that no test looks the same as another, and no student will almost never take an identical test twice. Because of the rigid structure of the questions file, care must be used to keep lines in the multiple choice questions in the order and format they first appear. Especially, it is of utmost importance to have a line break at the end of each line.

What to do

Test questions are usually initially created in the "Create questions" procedure. The questions are seeded with the concept, anchor and question present in the review questions which are also created by the "Create questions" procedure.

Clicking on the "Notify work completed" button sends out an automated message that alerts the webmaster and the coordinator who will decide if the page needs proofreading and editing or be moved to permanent folder. This also changes the color code for the page in the schedule of work done from grey to blue.

What file is saved and retrieved

When a page is retrieved, it is initially the latest temporary file. If a different version of the page is desired, it can be selected in the "temporary file" pull-down menu and the "Get" button should be clicked. If there is no temporary file, the only available file for the page is the permanent file. When the "Save" button is clicked, the page in the TEXTAREA is always saved in a temporary file which bears the numeral of the latest temporary file plus one.

Warning: Please note that the procedure is believed to contain at least one bug. Some users have reported that a portion or the entire file can be deleted occasionally. This has occurred when a totally empty question appears on the screen, and the user clicks on "Save". Normally, no empty question should ever appear. If it does appear, please, report that to the webmaster immediately indicating with as much detail as possible what steps you took that led to the appearance of an empty question. It is believed that the problem was caused by a missing parameter, such as "Answer", and the problem seems to have been fixed. In any case, report any problem you come across right away.