# [LON-CAPA-cvs] cvs: loncom /html/adm/help/tex Answer_Date.tex Course_Broadcast_Message.tex Course_Critical_Message.tex Course_Face_To_Face_Records.tex Course_Maximum_Collaborators.tex Course_Message_Access.tex Course_Problem_Weight.tex Distribute_Messages.tex Feedback_Author.tex Feedback_Content.tex Feedback_Discuss_Anon.tex Feedback_Discussion.tex Leaving_Feedback.tex Problem_Parameters.tex Resource_Discussion.tex Sending_Email.tex Table_Mode.tex

webbsuza lon-capa-cvs@mail.lon-capa.org
Mon, 07 Aug 2006 18:05:55 -0000

This is a MIME encoded message

--webbsuza1154973955
Content-Type: text/plain

webbsuza		Mon Aug  7 14:05:55 2006 EDT

Modified files:
Course_Critical_Message.tex
Course_Face_To_Face_Records.tex
Course_Maximum_Collaborators.tex
Course_Message_Access.tex
Course_Problem_Weight.tex
Distribute_Messages.tex
Feedback_Author.tex Feedback_Content.tex
Feedback_Discuss_Anon.tex
Feedback_Discussion.tex
Leaving_Feedback.tex
Problem_Parameters.tex
Resource_Discussion.tex Sending_Email.tex
Table_Mode.tex
Log:
changed wording, eliminating wordiness, changed some prepositions to fit, made a few punctuation changes

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

@@ -1,6 +1,6 @@

-The answer date is when the problem and answers are viewable to the
+The answer date is when the problem and its answer is viewable to the
student after the due date. If the answer date is mistakenly set for
a time before the due date, the answer date defaults to the due date.
If the answer date is not set, then students will not be able to see
@@ -9,9 +9,9 @@
\item Click \textbf{COM} in the remote control.
\item At the \textbf{Communication and Message} screen, select \textbf{Broadcast Message to Course}.
\item Type your message in the text box.
-\item If this is a critical message check to send as a critical message \ref{Course_Critical_Message}.
-\item Select the students you want the message sent to.
+\item If this is a critical message, check "send as a critical message" \ref{Course_Critical_Message}.
+\item Select the students to receive the message.
\item Click \textbf{Send Mail}.

\end{enumerate}
--- loncom/html/adm/help/tex/Course_Critical_Message.tex:1.6	Tue May  3 12:57:13 2005
+++ loncom/html/adm/help/tex/Course_Critical_Message.tex	Mon Aug  7 14:05:54 2006
@@ -3,7 +3,7 @@
recipient user logs in. The user must acknowledge receipt to continue; it
is not possible to use the rest of LON-CAPA until they do so.

-Only the Course Coordinator can send Critical Messages.
+Only the Course Coordinator and/or Instructor can send Critical Messages.

To send a Critical Message, do the following:

@@ -13,11 +13,8 @@
\item On each of the message sending
screens (\textbf{Send message to user(s)}, \textbf{Broadcast message
to course}, and \textbf{Upload message to course}), there are two
-checkboxes, \textbf{Send as critical message} and \textbf{Send as
-  critical message and return receipt}.
-\item \textbf{Send as critical message} will send this message as a critical
-message. \textbf{Send as critical message and return receipt} will
-send the message as a critical message, but additionally return a
-message to you each time a user acknowledges receipt of the message.
+checkboxes, \textbf{Send as critical message} which sends this message as a critical
+message, and \textbf{"Send as critical message and return receipt"}, which sends the message as a critical message, but additionally returns a
+message to you as users acknowledge receipt of the message.

\end{enumerate}
--- loncom/html/adm/help/tex/Course_Face_To_Face_Records.tex:1.5	Tue May  3 13:19:38 2005
+++ loncom/html/adm/help/tex/Course_Face_To_Face_Records.tex	Mon Aug  7 14:05:54 2006
@@ -6,7 +6,8 @@
\begin{enumerate}

\item Select \textbf{COM} on the Remote Control or Main Menu.
-\item At the \textbf{Communication and Messages} screen, click the \underbar{User
+\item At the \textbf{Communication and Messages} screen, click the
+\underbar{User
notes, record of face-to-face discussions, and critical messages}
--- loncom/html/adm/help/tex/Course_Maximum_Collaborators.tex:1.3	Mon May 17 18:08:56 2004
+++ loncom/html/adm/help/tex/Course_Maximum_Collaborators.tex	Mon Aug  7 14:05:54 2006
@@ -8,17 +8,17 @@
\item Select the role of Course Coordinator.
\item Click \textbf{NAV} on the remote control, or select
\textbf{navigate contents} from the Main Menu.
-\item Click on the essay problem you would like to set the maximum number of
-collaborators.
+\item Click on the essay problem that needs the maximum number of
+collaborators set.
\item Click \textbf{PPRM} on the remote control, or select
-At the \textbf{Set Course Parameter} screen a table will append to the page with all the
+At the \textbf{Set Course Parameter} screen, a table will append to the page with all the
parameters that can be set for the specific problem.
\item Scroll down to the \textbf{Maximum Number of Collaborators}
field in the \textbf{Parameter Name} column.
\item In the Course Columns, click "\textbf{-}" in the general column for entire course,
-click "\textbf{-}" in the for enclosing map or folder for a specific map or folder,
-click "\textbf{-}" in the resource column for a particular resource. A new window will
+click "\textbf{-}" in the "for enclosing map or folder" for a specific map or folder,
+click "\textbf{-}" in the "resource column" for a particular resource. A new window will
open.
\item Update the selected parameter.
\item Click \textbf{Store}.
--- loncom/html/adm/help/tex/Course_Message_Access.tex:1.3	Sun Jun 19 13:58:59 2005
+++ loncom/html/adm/help/tex/Course_Message_Access.tex	Mon Aug  7 14:05:54 2006
@@ -2,8 +2,7 @@

Select COM on the Remote Control or Main Menu to be brought to the
Communication Screen. If you use the remote control interface, you will know
-when you have a message waiting for you because the LED light on the upper
-will be displayed at the bottom of the main Communication Screen. In addition,
-on the \textbf{NAV} page, you see a letter icon next to any resource for which
-you received unread feedback messages. The subsections below describe the options available to you on the Communication Screen.
+when you have a message waiting for you because the LED light in the upper
+will be displayed at the bottom of the Main Communication Screen. In addition,
+on the \textbf{NAV} page, a letter icon appears next to any resource with unread feedback messages. The subsections below describe the options available to you on the Communication Screen.
--- loncom/html/adm/help/tex/Course_Problem_Weight.tex:1.5	Sun Jun 19 13:58:59 2005
+++ loncom/html/adm/help/tex/Course_Problem_Weight.tex	Mon Aug  7 14:05:54 2006
@@ -1,16 +1,16 @@
\label{Course_Problem_Weight}

-By default, the problem weight is equal to the amount of points the problem
-is worth. If the problem is made up of multiple parts each with their own submit
-button, then those parts behave as if they were separate problems
-and each have their own weight.
+By default, the problem "weight" is equal to the amount of points the problem
+is worth. If the problem is made up of multiple parts, each with their own submit
+button, then those parts behave as if they were separate problems,
+and each one has its own weight.

If you want to edit the default (i.e award points based on problem weight and
and the change the Course Environment Parameters \ref{GradingOptions}. In this
-case, you may want to think of a problem's weight in comparison to other
-problems.  For example, all problems with a weight of 1 means that both easy and
-difficult problems are given the same weight.  If you choose to customize the
+case, you may want to think of a problem's weight in proportion to other
+problems.  For example, if all problems have a weight of 1, then both easy and
+difficult problems have the same weight.  If you choose to customize the
spreadsheet, then the problem weight and points may not equal each other for

--- loncom/html/adm/help/tex/Distribute_Messages.tex:1.1	Sun Jun 19 13:58:59 2005
+++ loncom/html/adm/help/tex/Distribute_Messages.tex	Mon Aug  7 14:05:54 2006
@@ -1,7 +1,6 @@
\label{Distribute_Messages.tex}

-Create a file with the specified format and send it to students in
+Create a file with the specified format to send to your students:

@@ -10,12 +9,13 @@
For example:

-gsmith98765@msu:Please stop by office hours so we can discuss your
+gsmith98765@msu: Please stop by during office hours so we can discuss your

-You can choose to send this message as critical.
+
+You can choose to send this type of message as critical.

--- loncom/html/adm/help/tex/Feedback_Author.tex:1.1	Sun Jun 19 13:58:59 2005
+++ loncom/html/adm/help/tex/Feedback_Author.tex	Mon Aug  7 14:05:54 2006
@@ -2,6 +2,6 @@

Only the author of the resource can view this feedback. The author
receives the feedback as a message on their Communication Screen.
-The feedback automatically becomes part of the problems metadata.
+The feedback automatically becomes part of the problem's metadata.
Feedback understands smilies, \LaTeX{}, and HTML. Instructors can
-change feedback and discussion options in the course environment.
+change feedback and discussion options within the course environment.
--- loncom/html/adm/help/tex/Feedback_Content.tex:1.2	Wed Jul 12 13:28:31 2006
+++ loncom/html/adm/help/tex/Feedback_Content.tex	Mon Aug  7 14:05:54 2006
@@ -4,10 +4,10 @@
specified in the Course Environment as the person to receive resource
content questions. If no instructor is defined in the Course Environment,
this option does not appear in the feedback window. The instructor
-is notified that a question is waiting for her with a little envelope
+is notified that a question is waiting by the appearance of a little envelope
-also see the message from her Communication Screen. The student's
-version of the problem along with previous submissions is attached
+also see the message from the Communication Screen. The student's
+version of the problem, along with previous submissions, is attached
to the message. When the instructor replies to the message, the student
-is notified that a reply is waiting for him with the same envelope
+is notified that a reply is waiting by that same envelope
--- loncom/html/adm/help/tex/Feedback_Discuss_Anon.tex:1.1	Sun Jun 19 13:58:59 2005
+++ loncom/html/adm/help/tex/Feedback_Discuss_Anon.tex	Mon Aug  7 14:05:54 2006
@@ -1,6 +1,6 @@
\label{Feedback_Discuss_Anon}

Same as above except that the student's real name is not visible to
-other students and is replaced by the word ''anonymous'' or the
+other students and is replaced by the word ''anonymous'' or by the
student's screen name. Instructors and Course Coordinators can see
the student's name.
--- loncom/html/adm/help/tex/Feedback_Discussion.tex:1.1	Sun Jun 19 13:58:59 2005
+++ loncom/html/adm/help/tex/Feedback_Discussion.tex	Mon Aug  7 14:05:54 2006
@@ -3,7 +3,7 @@
Instead of the text sent as a message to an instructor, the text is
displayed publicly at the bottom of the resource. Course Coordinators
and Instructors can hide or delete discussion postings. The student's
-name in the posting is a link to his About Me page. Everyone in the
+name in the posting is a link to his or her "About Me" page. Everyone in the
class is notified of new discussion with a little bubble icon next
to the problem name on the Navigation Screen.

--- loncom/html/adm/help/tex/Leaving_Feedback.tex:1.5	Sun Jun 19 13:58:59 2005
+++ loncom/html/adm/help/tex/Leaving_Feedback.tex	Mon Aug  7 14:05:54 2006
@@ -4,12 +4,12 @@

\begin{enumerate}

-\item Open the resource page you want to submit feedback for.
+\item Open the resource page where you want to submit feedback.
\item Click \textbf{FDBK} on remote control.
\item At the \textbf{Resource and Feedback Discussion} screen, check at least one of the
listed feedback types to direct where your feedback is sent (see \ref{Feedback_Author}, \ref{Feedback_Content}, \ref{Feedback_Policy}, \ref{Feedback_Discussion}, and \ref{Feedback_Discuss_Anon} for further explanation).
-\item Type feedback comment or question in text box.
+\item Type your feedback, comment, or question in text box.
+\item If applicable, add an attachment.
\item Click \textbf{Send}.

\end{enumerate}
--- loncom/html/adm/help/tex/Problem_Parameters.tex:1.2	Wed Jul 12 13:28:31 2006
+++ loncom/html/adm/help/tex/Problem_Parameters.tex	Mon Aug  7 14:05:54 2006
@@ -3,7 +3,6 @@
Go to a problem resource and click on PPRM on the Remote Control or
on the Inline Menu to set parameters for the current problem. The
screen is similar to the resource level parameter setting in table
-format except information only shows up for the one particular problem
-you are currently at. \emph{Make sure to only make changes in the
+format, except information only shows up for the current problem. \emph{Make sure to only make changes in the
''for Resource'' column.} If the interface seems confusing, then
-it is suggested that you use PARM and choose the Helper Mode.
+we suggest you use PARM and choose the Helper Mode.
--- loncom/html/adm/help/tex/Resource_Discussion.tex:1.3	Sun Jun 19 13:58:59 2005
+++ loncom/html/adm/help/tex/Resource_Discussion.tex	Mon Aug  7 14:05:54 2006
@@ -1,13 +1,11 @@
\label{Resource_Discussion}

Unless banned by an instructor, all resources in the course can host
-discussion, which means students may post comments that will appear
-for all viewers on the resource. Course members will see new discussion
+discussion, which means students may post comments that will appear to all viewers. Course members will see new discussion
on their Navigation screens. Instructors may allow course members
-to post anonymously or not, and course personnel can see who posted
-the anonymous messages. Anonymous only prevents students from seeing
-the poster. (Sometime instructors or TAs post anonymously to discreetly
+to post anonymously or not, and course personnel can still see who posted
+the anonymous messages. "Anonymous" only prevents students from knowing who posted. (Sometimes instructors or TAs post anonymously to discreetly
help the students.) Course personnel may hide or delete inappropriate
messages.

-To participate in a discussion on the a resource click the \underbar{Post Discussion} link at the bottom of a resource.  If you want to reply back to a particular post, then click the appropriate \underbar{Reply} link.
+To participate in a discussion on the a resource, click the \underbar{Post Discussion} link at the bottom of a resource.  If you want to reply back to a particular post, then click the appropriate \underbar{Reply} link.
--- loncom/html/adm/help/tex/Sending_Email.tex:1.3	Sun Jun 19 13:58:59 2005
+++ loncom/html/adm/help/tex/Sending_Email.tex	Mon Aug  7 14:05:54 2006
@@ -1,20 +1,21 @@
\label{Sending_Email}
-To send internal LON-CAPA email messages, do the following:
+
+To send internal LON-CAPA email messages:

\begin{enumerate}

\item Click \textbf{COM} on the remote control.
\item At the \textbf{Communication and Message} screen, select \textbf{Send Message to User(s)}.
-\item Type the username you want to send email to.
+\item Type the "username" you want to send email to.

-\textbf{Note}: If you don't know the user name you can click on the Select User link.
+\textbf{Note}: If you don't know the user name, click on the Select User link.
Another screen will open and you can select a user from the list.

-\item Type the \textbf{Subject} in the subject text box.
+\item Type the \textbf{Subject} in the "subject" text box.
\item Type the message in the text box.
-\item If this is a critical message, select send as critical message or send as a
-critical message and return receipt, \ref{Course_Critical_Message}. (Only instructors can send
+\item If this is a "critical message," select "send as critical message" or "send as a
+critical message and return receipt," \ref{Course_Critical_Message}. (NOTE: Only instructors and course coordinators can send
critical messages.)
\item Click \textbf{Send New Mail}.

--- loncom/html/adm/help/tex/Table_Mode.tex:1.3	Tue Jul 18 13:21:52 2006
+++ loncom/html/adm/help/tex/Table_Mode.tex	Mon Aug  7 14:05:54 2006
@@ -14,16 +14,16 @@

\begin{enumerate}
-\item Course level: The course default, will apply the parameter to every resource in the course.
+\item Course level: The course default; will apply the parameter to every resource in the course.
\item Map/Folder level: Will apply the parameter to all resources in a
-particular folder or map and will override the course defaults.
-\item Resource level: Parameters apply only to one particular problem and it
-overrides the map/folder level and course level parameters.  You may want to
+particular folder or map, and will override the course defaults.
+\item Resource level: Parameters apply only to one particular problem and those parameters
+override the map/folder level and course level parameters.  You may want to
use the Problem Parameter functionality (PPRM) instead (\ref{Problem_Parameters}).

\end{enumerate}

-If you choose the map/folder level or resource level, you be given options to
+If you choose the map/folder level or resource level, you will be given options to
choose which folder/map you want to display.

To set parameters, click on the underscore link in the appropriate

--webbsuza1154973955--