webbsuza lon-capa-cvs@mail.lon-capa.org
Mon, 24 Jul 2006 13:37:00 -0000

This is a MIME encoded message

--webbsuza1153748220
Content-Type: text/plain

webbsuza		Mon Jul 24 09:37:00 2006 EDT

Modified files:
Docs_Check_Resource_Versions.tex
Docs_Dump_Course_Docs.tex Docs_Essay.tex
Docs_Navigate_Content.tex
Docs_String_Response.tex
Log:
changed wording from passive to active; eliminated wordiness; corrected  a couple of typos

--webbsuza1153748220
Content-Type: text/plain
Content-Disposition: attachment; filename="webbsuza-20060724093700.txt"

@@ -1,17 +1,17 @@
-
-To add resources not included in the LON-CAPA
-content network, do the following:
-
-\begin{enumerate}
-
-\item Click the \fbox{External
-Resource} button on the \textbf{Course Documents} screen.
-\item Type in the title of the web resource you wish to add in the \textbf{Title} text box.
-\item Type in the URL of the web resource in the \textbf{URL} text box.
-\item Click the \fbox{View} button to see if the web resource is in the frame below the entry fields.
-\item Click the \fbox{Choose} button to add the web resource to the course.
-
-\end{enumerate}
-
-NOTE: Your new resources will be visible the next time you log in, or by clicking the \fbox{re-initializing course} button on the \textbf{Course Documents} screen, whichever comes first.
+
+To add resources not included in the LON-CAPA
+content network, do the following:
+
+\begin{enumerate}
+
+\item Click the \fbox{External
+Resource} button on the \textbf{Course Documents} screen.
+\item Type in the title of the web resource you wish to add in the \textbf{Title} text box.
+\item Type in the URL of the web resource in the \textbf{URL} text box.
+\item Click the \fbox{View} button to see if the web resource is in the frame below the entry fields.
+\item Click the \fbox{Choose} button to add the web resource to the course.
+
+\end{enumerate}
+
+NOTE: Your new resources will be visible the next time you log in, or by \fbox{re-initializing course}.
@@ -1,38 +1,37 @@
-combine separate content items together for display in a single web page.
-Composite pages can contain uploaded files, homework problems imported
-from the resource repository, and/or simple problems created using the
-problem editor. To add a composite page to your course, do the following:
-
-\begin{itemize}
-
-\item Click \textbf{DOCS} on the remote control.
-\item In the \textbf{Course Documents} screen, click the \textbf{New
-Composite Page}  button in the \textbf{Special documents} column.
-\item In the pop up window, type the name of the new page and click OK.
-
-The page will appear at the bottom of the course document area to which you added it.
-
-\item To add resources to the page, click on the page you created.
-
-\end{itemize}
-
-Th course document screen will refresh, and the updated display will
-include the name of the new page appended to the end of the breadcrumb
-trail, that extends to the right of the \textbf{Main Course Documents} label.
-The page is currently empty. Add new resources to the page as you would
-add resources to a Folder or to the "top-level" Course Documents area
-except that only a subset of the "Special documents" that may be
-placed in a folder, can be placed in a composite page. Also, if you use
-"Import" to include a published sequence in a page, then when the page is
-displayed the sequence will be opened and all of its contents will appear as
-elements of the composite page (i.e., no "folder" will appear in the page).
-If you wish to be able to hide selected elements from the sequence, you should
-use "Select Map" and "Load Map" to unpack the sequence prior to import.
-
-after clicking the \textbf{re-initializing course} button on the course
-document screen, whichever comes first.
+combine separate content items together for display in a single web page.
+Composite pages can contain uploaded files, homework problems imported
+from the resource repository, and/or simple problems created using the
+problem editor. To add a composite page to your course, do the following:
+
+\begin{itemize}
+
+\item Click \textbf{DOCS} on the remote control.
+\item In the \textbf{Course Documents} screen, click the \textbf{New
+Composite Page}  button in the \textbf{Special documents} column.
+\item In the pop up window, type the name of the new page and click OK.
+
+The page will appear at the bottom of the course document area to which you added it.
+
+\item To add resources to the page, click on the page you created.
+
+\end{itemize}
+
+The Course Document screen will refresh, and the updated display will
+include the name of the new page appended to the end of the breadcrumb
+trail, that extends to the right of the \textbf{Main Course Documents} label.
+The page is currently empty. Add new resources to the page as you would
+add resources to a Folder or to the "top-level" Course Documents area
+except that only a subset of the "Special documents" that may be
+placed in a folder, can be placed in a composite page. Also, if you use
+"Import" to include a published sequence in a page; then when the page is
+displayed; the sequence will open and all of its contents appear as
+elements of the composite page (i.e., no "folder" will appear in the page).
+If you wish to be able to hide selected elements from the sequence, you should
+use "Select Map" and "Load Map" to unpack the sequence prior to import.
+
+by \textbf{re-initializing course} .
--- loncom/html/adm/help/tex/Docs_Check_Resource_Versions.tex:1.2	Tue May  3 12:05:05 2005
+++ loncom/html/adm/help/tex/Docs_Check_Resource_Versions.tex	Mon Jul 24 09:36:59 2006
@@ -1,22 +1,21 @@
-\label{Docs Check Resource Versions}
-To check or set the versions of your resouces, do the following:
-
-\begin{enumerate}
-
-\item Select \textbf{DOCS} on the Remote Control or Main Menu.
-\item Click the \fbox{Check/Set Resource Versions} button at the top of
-the \textbf{Course Documents} screen to see which resources have been updated over a specific
-time frame.
-
-\end{enumerate}
-
-NOTE:  By default, when you import a resource, you always get
-the latest resource and that resource will update to the latest if
-the author publishes changes. Using the Check/Resource Version tool,
-you can lock all of your resources in their current version. You can
-also view which changes have occured in a particular time frame by
-choosing a this time frame from the drop-down box and clicking
-the \fbox{Display} button. From here, you can choose to lock one
-or more individual resources in place. It is recommended that you leave
-the default settings to keep all resources up-to-date because most
-resource changes are improvements by the author.
+\label{Docs Check Resource Versions}
+To check or set the versions of your resouces, do the following:
+
+\begin{enumerate}
+
+\item Select \textbf{DOCS} on the Remote Control or Main Menu.
+\item Click the \fbox{Check/Set Resource Versions} button at the top of
+the \textbf{Course Documents} screen to see which resources have been updated over a specific
+time frame.
+
+\end{enumerate}
+
+NOTE:  When you import a resource, you get
+the most current resource by default. By using the Check/Resource Version tool,
+you can lock all of your resources in their current versions. You can
+also view which changes have occured in a particular time frame by
+choosing a This Time Frame from the drop-down box and clicking
+the \fbox{Display} button. From here, you can choose to lock one
+or more individual resources in place. LON-CAPA recommends that you use
+the default settings to keep all resources up-to-date because most
+resource changes are improvements by their authors.
--- loncom/html/adm/help/tex/Docs_Dump_Course_Docs.tex:1.2	Tue May  3 12:06:41 2005
+++ loncom/html/adm/help/tex/Docs_Dump_Course_Docs.tex	Mon Jul 24 09:36:59 2006
@@ -1,9 +1,9 @@
-\label{Docs Dump Course Docs}
-If you have authoring privileges, you will see the \fbox{Dump Course Docs to Construction Space} button. This feature will
-let you copy the material you created with the tools in the \textbf{Course Documents} screen
-to your construction space. You can then add this material to the
-LON-CAPA resource pool by publishing it. \emph{Dumping problems created
-with the Simple Problem Editor currently is not supported. The feature
-will be supported in the future and you will eventually be able to
-copy these problems to constructions space.}
-
+\label{Docs Dump Course Docs}
+Those with authoring privileges will see the \fbox{Dump Course Docs to Construction Space} button. This feature allows
+you to copy the material created with the tools in the \textbf{Course Documents} screen
+into your construction space. You can then add this material to the
+LON-CAPA resource pool by publishing it. \emph{Dumping problems created
+with the Simple Problem Editor is not currently supported. The feature
+will be supported in the future and you will eventually be able to
+copy these problems to the construction space.}
+
--- loncom/html/adm/help/tex/Docs_Essay.tex:1.1	Sun Jun 13 18:57:09 2004
+++ loncom/html/adm/help/tex/Docs_Essay.tex	Mon Jul 24 09:36:59 2006
@@ -1,9 +1,8 @@
-\label{Docs Essay}
-Enter your question text into the appropriate location and click the
-\fbox{Store Changes}  button when you are done. Students will see
-your question text and be given a text block to enter in their short
-answer essay. Using the parameters, you can allow students to submit
-their essays in groups and allow your students to upload a file to
-give to you, such as a Word document.
-
-
+\label{Docs Essay}
+Enter your question text into the appropriate location and click the
+\fbox{Store Changes}  button when you are done. Students will see
+your question text with a text block in which to enter in their short
+answer essay. Using the parameters, choose whether students submit
+their essays in groups or individually, and choose to allow students the ability to upload files, such as a Word document.
+
+
--- loncom/html/adm/help/tex/Docs_Navigate_Content.tex:1.3	Tue May  3 11:39:22 2005
+++ loncom/html/adm/help/tex/Docs_Navigate_Content.tex	Mon Jul 24 09:36:59 2006
@@ -1,7 +1,6 @@
-\label{Docs_Navigate_Content}
-A \textbf{Navigate Content} page will display the exact same page as the
-the Main Course Sequence. They are the documents that make up the course itself and the user will use the
-navigation controls to move through them. Putting a \textbf{Navigate Course Contents} page allows you to place that
-screen on the sequence the students will see. Some instructors like to
-use this as the first page in the course.
+\label{Docs_Navigate_Content}
+A \textbf{Navigate Content} page displays the exact same page as the
+the Main Course Sequence. These resources are the documents that make up the course itself. Users will use the
+navigation controls to move through the documents. Putting a \textbf{Navigate Course Contents} page in your course allows that
+screen to be the first page the students see; this appeals to some instructors.
--- loncom/html/adm/help/tex/Docs_Option_Response.tex:1.1	Sun Jun 13 18:57:09 2004
+++ loncom/html/adm/help/tex/Docs_Option_Response.tex	Mon Jul 24 09:36:59 2006
@@ -1,17 +1,14 @@
-\label{Docs Option Response}
-The Option Response question type is a matching question. Instead
-of students selecting one true foil from a list, each foil has a drop-down
-box in front of it where students have to select the correct option
-for each statement. The editing of this problem type is very similar
-to editing the 1 out of N multiple choice problem. Enter your question
-text into the appropriate location. In the add a new option text,
-add one of the drop-down box options and then click the \fbox{Store Changes}
-button. Repeat adding options until you have added all that you want
-to use. If you make a mistake, you can select an option that you want
-to delete and then click \fbox{Store Changes}  to save your changes.
-After adding all of your options, type in the text for each foil and
-assign each option the correct value and location. You can add an
-optional hint if you want. When you are done editing, click the \fbox{Store Changes} Store
-Changes button and close the window by selecting the {}x'' in
-the upper right-hand corner of the window.
-
+\label{Docs Option Response}
+The Option Response question type is a matching question. Instead
+of students selecting one true foil from a list, each foil has a drop-down
+box in front of it where students have to select the correct option
+for each statement. The editing of this problem type is very similar
+to editing the 1 out of N multiple choice problem. Enter your question
+text into the appropriate location. In the Add a New Option text,
+add one of the drop-down box options and then click the \fbox{Store Changes}
+button. Repeat adding options until you have added all you want. If you make a mistake, select an option to delete and then click \fbox{Store Changes} .
+After adding all of your options, type in the text for each foil and
+assign each option the correct value and location. You can add an
+optional hint. When finished editing, click the \fbox{Store Changes} button and close the window by selecting the {}x'' in
+the upper right-hand corner of the window.
+
@@ -1,27 +1,26 @@
-This is a question where students can choose only one correct answer
-out of a selection. Each selection choice is called a foil because
-the majority of the selection choices try to foil the student. Only
-one foil is correct. LON-CAPA will randomly display the foils to your
-students. If you choose to set the max number of displayed foils to
-4 but only have 6 foils then LON-CAPA will choose one of the True
-foils and fill in the rest of the foils with false foils up to a maximum
-of four foils. To edit the 1 out of N multiple choice problem, enter
-your question text into the appropriate box. Then enter one foil statement
-in each foil box that you would like to use. You do not have to use
-all 10 of the foil boxes. For each foil that you do use, you will
-need to assign it a value of True or False. You can assign a foil
-a location if you choose. For example, the foils will apear in random
-order for your students. If you have a foil statement of {}None
-of the above'' then you will want this statement to always appear
-at the bottom. After entering all of the correct foil text, you can
-add an optional hint. The hint text will appear under your student's
-view of the problem after getting one incorrect submission. The hint
-text will remain displayed on your students view of the problem after
-it is correct for study purposes. At any point in the editing process,
-you can choose to store your changes. Each time you click \fbox{Store Changes}
-, the current view of your problem will appear in box at the top of
-the edit screen. When you are done editing, click the \fbox{Store Changes}
-button and close the window by selecting the {}x'' in the upper
-right-hand corner of the window.
-
+This is a question where students can choose only one correct answer
+from a selection. Each choice in the selection is called a "foil" because
+the majority of the selection choices try to foil the student. Only
+one foil is correct. LON-CAPA randomly displays the foils to students. If you choose to set the max number of displayed foils to
+4, but only have 6 foils then LON-CAPA will choose one of the True
+foils and fill in the rest of the foils with false foils, up to a maximum
+of four foils. To edit the 1 out of N multiple choice problem, enter
+your question text into the appropriate box. Then enter one foil statement
+into each foil box you want to use. You do not have to use
+all 10 of the foil boxes. For each foil you do use, you
+need to assign it a value of True or False. You can choose to assign a foil
+a location. For example, the foils apear in random
+order to your students. If you have a foil statement of {}"None
+of the above," then you want this statement to always appear
+at the bottom. After entering all of the correct foil text, you can
+add an optional hint. The hint text appears under the student's
+view of the problem after getting one incorrect submission. The hint
+text remains displayed on your students' views of the problem after
+it is correct, for study purposes. At any point in the editing process,
+you can choose to store your changes. Each time you click \fbox{Store Changes}
+, the current view of the problem will appear in box at the top of
+the edit screen. When finished editing, click the \fbox{Store Changes}
+button and close the window by selecting the {}x'' in the upper
+right-hand corner of the window.
+
@@ -1,21 +1,21 @@
-
-A \textbf{Score Upload Form} is a page in LON-CAPA that stands in for a score in an
-assignment external to LON-CAPA. You can insert a Score Upload Form into
-your course, and use it to enter student's scores for an exam, project, or
-any other assignment. The easiest way to do this is via the \textbf{PGRD} \textbf{Grading} screen \ref{Course_Student_Grade_Override}, which allows you to upload a CSV file containing students'
-scores.
-
-To create a Score Upload Form, do the following:
-
-\begin{enumerate}
-
-\item Select \textbf{DOCS} on the Remote Control or Main Menu.
-\item At the \textbf{Course Documents} screen, click the \fbox{Score
-Upload Form} button in the \textbf{Special documents} column.
-\item At the window pop-up, type the name of the Score Upload Form and click the \fbox{OK} button.
-
-\end{enumerate}
-
-The page will be added to the end of the current course document folder.
+
+A \textbf{Score Upload Form} is a page in LON-CAPA that stands in for a score in an
+assignment external to LON-CAPA. You can insert a Score Upload Form into
+your course, and use it to enter student's scores for an exam, project, or
+any other assignment. The easiest way to do this is via the \textbf{PGRD} \textbf{Grading} screen \ref{Course_Student_Grade_Override}, which allows you to upload a CSV file containing students'
+scores.
+
+To create a Score Upload Form, do the following:
+
+\begin{enumerate}
+
+\item Select \textbf{DOCS} on the Remote Control or Main Menu.
+\item At the \textbf{Course Documents} screen, click the \fbox{Score
+Upload Form} button in the \textbf{Special documents} column.
+\item At the window pop-up, type the name of the Score Upload Form and click the \fbox{OK} button.
+
+\end{enumerate}
+
+The page will be added to the end of the current course document folder.
--- loncom/html/adm/help/tex/Docs_String_Response.tex:1.1	Sun Jun 13 18:57:09 2004
+++ loncom/html/adm/help/tex/Docs_String_Response.tex	Mon Jul 24 09:36:59 2006
@@ -1,6 +1,6 @@
-\label{Docs String Response}
-This question type gives your students a small text box where they
-can enter in their answer in the form of any string, most appropriately
-a word, but a number or short phrase will work as well. You can choose
-to have your string response be case senstive or case insensitive.
-
+\label{Docs String Response}
+This question type gives students a small text box where they
+can enter their answer in the form of any string; most appropriately
+a word, but a number or short phrase will work as well. You choose
+whether string responses are case senstive or not.
+
@@ -1,23 +1,22 @@
-can be uploaded into your course, such as PowerPoint presentations or PDF
-files.
-
-To upload a file from your hard drive into the course, do the following:
-
-\begin{enumerate}
-
-\item Create the document and save it to your hard drive.
-\item Select \textbf{DOCS} on the Remote Control or Main Menu.
-\item In the \textbf{Upload a new main course document} or
-\textbf{Upload a new supplement course document} area,
-either type the path to your document or click the \fbox{Browse...} button to find the document on
-\item Type the title in the Title text box.
-\item Click the \fbox{Upload Document} button.
-
-\end{enumerate}
-
-clicking the \fbox{re-initializing course} button on the \textbf{Course
-Document} screen, whichever comes first.
+files).
+
+To upload a file from your hard drive into the course, do the following:
+
+\begin{enumerate}
+
+\item Create the document and save it to your hard drive.
+\item Select \textbf{DOCS} on the Remote Control or Main Menu.
+\item In the \textbf{Upload a new main course document} or
+\textbf{Upload a new supplement course document} area,
+either type the path to your document or click the \fbox{Browse...} button to find the document on