<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE document PUBLIC "-//CNX//DTD CNXML 0.5//EN" "http://cnx.rice.edu/cnxml/0.5/DTD/cnxml_plain.dtd">
<document xmlns="http://cnx.rice.edu/cnxml" xmlns:md="http://cnx.rice.edu/mdml/0.4" xmlns:bib="http://bibtexml.sf.net/" id="m10288">
  
  <name>How to Use the Course Composer</name>

  <metadata>
  <md:version>2.17</md:version>
  <md:created>2001/08/09</md:created>
  <md:revised>2004/08/13 17:04:08.198 GMT-5</md:revised>
  <md:authorlist>
      <md:author id="selc">
      <md:firstname>Sarah</md:firstname>
      
      <md:surname>Coppin</md:surname>
      <md:email>coppin@alumni.rice.edu</md:email>
    </md:author>
      <md:author id="mhusband">
      <md:firstname>Mark</md:firstname>
      <md:othername>S.</md:othername>
      <md:surname>Husband</md:surname>
      <md:email>mhusband@rice.edu</md:email>
    </md:author>
  </md:authorlist>

  <md:maintainerlist>
    <md:maintainer id="selc">
      <md:firstname>Sarah</md:firstname>
      
      <md:surname>Coppin</md:surname>
      <md:email>coppin@alumni.rice.edu</md:email>
    </md:maintainer>
    <md:maintainer id="mizar">
      <md:firstname>Christine</md:firstname>
      
      <md:surname>Donica</md:surname>
      <md:email>mizar@alumni.rice.edu</md:email>
    </md:maintainer>
    <md:maintainer id="jenn">
      <md:firstname>Jenn</md:firstname>
      <md:othername>A.</md:othername>
      <md:surname>Drummond</md:surname>
      <md:email>jenn@rice.edu</md:email>
    </md:maintainer>
    <md:maintainer id="brentmh">
      <md:firstname>Brent</md:firstname>
      <md:othername>Michael</md:othername>
      <md:surname>Hendricks</md:surname>
      <md:email>brentmh@rice.edu</md:email>
    </md:maintainer>
    <md:maintainer id="mhusband">
      <md:firstname>Mark</md:firstname>
      <md:othername>S.</md:othername>
      <md:surname>Husband</md:surname>
      <md:email>mhusband@rice.edu</md:email>
    </md:maintainer>
    <md:maintainer id="jago">
      <md:firstname>Adan</md:firstname>
      
      <md:surname>Galvan</md:surname>
      <md:email>jago@rice.edu</md:email>
    </md:maintainer>
  </md:maintainerlist>
  
  <md:keywordlist>
    <md:keyword>course composer</md:keyword>
    <md:keyword>tutorial</md:keyword>
    <md:keyword>module</md:keyword>
    <md:keyword>group</md:keyword>
    <md:keyword>course</md:keyword>
  </md:keywordlist>

  <md:abstract>Instructions on how to use the Connexions Course Composer.</md:abstract>
</metadata>


  <content>
    <section id="intro">
      <name>Course Composer</name>
    <para id="delete_me">
      The Connexions Course Composer allows you to create a new course
      or to edit an existing course. You can perform the following
      tasks with the Course Composer:
      <list type="bulleted" id="firstlist">
	<item><cnxn target="create">Create a New Course</cnxn></item>
        <item><cnxn target="metadata">Enter Identifying Metadata for a New Course</cnxn></item>
	<item><cnxn target="addsection">Add a New Section</cnxn></item>
	<item><cnxn target="subsection">Add a Subsection</cnxn></item>
	<item><cnxn target="addmodulesection">Add a Module</cnxn></item>
	<item><cnxn target="changetitle">Provide an Alternate Module Title</cnxn></item>
	<item><cnxn target="setversion">Select the Module Version</cnxn></item>
	<item><cnxn target="editaddlinkssection">Edit or Add Links</cnxn></item>
	<item><cnxn target="rearrange">Rearrange Contents</cnxn></item>
	<item><cnxn target="removesection">Remove Course Contents</cnxn></item>
	<item><cnxn target="addroles">Assign Roles to Collaborating Authors</cnxn></item>
	<item><cnxn target="notationsection">Set Notation Parameters</cnxn></item>
	<item><cnxn target="previewsection">Preview the Course</cnxn></item>
	<item><cnxn target="publishcoursesec">Publish the Course</cnxn></item>
	<item><cnxn target="existintsection">Edit an Existing Course</cnxn></item>
      </list>
    </para>   
    </section>
    
    <section id="create">
      <name>Create a New Course</name>

      <para id="create1">
	Creating a new course is similar to creating a 
	<cnxn target="creatingmodules" document="m10885">new module</cnxn>. 
	You access the Course Composer from your workspace or 
	<link src="http://cnx.rice.edu/help/reference/workgroups">workgroup</link>. 

	<list id="createlist" type="enumerated">
	  <item>Select Course from the drop-down list next to the 
	  <code>Create New Item</code> button and click <code>Create New Item</code>.
          The "New Content: Licensing" screen displays.
	  </item>
	  <item>Select the check box at the bottom of the screen to
	  signify that you agree to place the course under the 
	  <link src="http://creativecommons.org/licenses/by/1.0/">Creative Commons 
	  Attribution license</link>.</item>
	  <item>Click <code>Next</code>. The "Metadata" tab displays with the message 
	  that a course has been created. The "Course Status" sidebar appears on 
	  the right side of the screen and lists the current state of the course 
	  and the last action taken, which was creation of the course along with 
	  the name of the person who created the course and when they created it.
	  </item>
      </list>
    </para>   
       
      <figure id="coursecomposerfig1">
	<media type="image/png" src="coursecomposerfig1.png"/>
	<caption>Course Composer editing screen</caption>
      </figure>
      
    </section>

    <section id="metadata">
      <name>Enter Identifying Metadata for a New Course</name>

      <para id="metadata1">
	<list id="metadatalist" type="enumerated">
	<item>Select the "Metadata" tab in the Course Composer.</item>
	  <item>Enter the appropriate information in the metadata
	  fields, including:
	    <list id="sublist" type="bulleted">
	      <item>course title (required)</item>
	      <item>institution name - institution where the course
	      will be taught</item>
	      <item>course code - the catalog number, for example, BIO
	      201</item>
	      <item>instructor name - the person teaching the
	      course</item>
	      <item>course home page - a full URL beginning with
	      "http://". Examples are course announcement pages or the course 
	      syllabus</item>
	      <item>keywords - terms that aid Connexions users to
	      search and find the course</item>
	      <item>abstract - a brief description of the course (required)</item>
	    </list>
	    If you do not make an entry in a required field, you will
	    be prompted for an entry when you click <code>Save</code> to record 
	    the metadata.</item>
	  <item>Click <code>Save</code>. The metadata entries are saved and the 
	  "Contents" tab displays with the title of the course. This tab is where 
	  you do the actual assembly of the course. It has two areas. The left 
	  side of the tab has a course outline display. The right side of the 
	  tab is where you add, arrange, or remove content objects in the course.
	  </item>
	</list>
      </para>
    </section>

    <section id="addsection">
      <name>Add a New Section</name>

      <para id="addsectionpara1">
	A section is a grouping of related modules within a course. Each section has a heading that identifies its contents to the viewers. You may place sections within sections, creating subsections. 
      </para>
  
      <list id="addnewsection" type="enumerated">
	<item>Select the "Contents" tab in the Course Composer.</item>
	<item>Click on the title of the course in the course outline,
	if it is not already highlighted. It is the highest-level
	object in the course outline.</item>
	<item>Display the "Contents" tab, if it is not already
	displaying.</item>
	<item>Click <code>Add New Section</code> in the "Contents" tab.
        A new section is added to the course outline as the last object 
        and the "Edit" tab
	displays with a blank field for the name of the new section. 
	</item>
	<item>Enter the name of the new section in the "Title" field. 
	</item>
	<item>Click <code>Save</code>.</item>
      </list>

      <para id="addpara">
	The title you entered appears as the new section in the
	course outline. This section is highlighted, enabling you
	to add content to it in the form of a subsection or a module.
      </para>

    </section>
    
    <section id="subsection">
      <name>Add a Subsection</name>

      <para id="subsectionpara1">
	A subsection is a grouping of related modules within a section. 
	Each subsection has a heading that identifies its contents to 
	the viewers.  
      </para>

      <list type="enumerated" id="addsubsectionlist">
	<item>Select the "Contents" tab in the Course Composer. </item>
	<item>Click on the section title in the course outline, if
	it is not already highlighted.</item>
	<item>Display the "Contents" tab, if it is not already
	displaying.</item>
	<item>Click <code>Add New Section</code> in the "Contents" tab. 
        A new subsection is added to the course outline under the section 
        that was highlighted. The "Edit" tab displays with a blank "Title" 
        field for the name of the subsection. </item>
	<item>Enter the name of the subsection in the "Title" field.</item>
	<item>Click <code>Save</code>.</item>
      </list>
    
      <para id="subsectionpara">
	The title you entered appears as the new subsection in the
	course outline. This subsection is highlighted, enabling
	you to add content to it.
      </para>
    </section>

    <section id="addmodulesection">
      <name>Add a Module</name>

      <para id="addmodulepara1">
	You can add a published module to the course from the Content 
	Commons or from the course's own workspace or 
	<link src="http://cnx.rice.edu/help/reference/workgroups">workgroup</link>. 
	When adding a module, Connexions does not copy the module into your 
	course. The module remains in the Content Commons and Connexions 
	inserts a reference or a pointer to the module in your course. Any 
	new or existing modules can be added to a course with the following
	considerations:
      
      <list id="addmodulelist" type="bulleted">
	<item>A module cannot be inserted into a course more than once.</item>
	<item>A module must be published in Connexions before you can 
	insert it into a course.</item>
	<item>Searches in the Content Commons for modules use titles,
	names, authors, keywords, or text strings.</item>
      </list>
	If no matches are found for your search string,
	Connexions displays some suggestions about search entries. 
      </para>

 <section id="commonsmodulesection">
      <name>Add a Module from the Content Commons</name>
      <para id="addmoudlpara3">
	To search the Content Commons for a module and add it as
	content in your course, use the following steps:
	<list id="commonssearch" type="enumerated">
	  <item>Select the "Contents" tab in the Course Composer, if it is not 
	  already displaying.</item>
	  <item>Click on the item title in the course outline where you 
	  want to insert the module, if it is not already highlighted. This 
	  item could be the course title, a section title, or a subsection 
	  title.</item>
	  <item>Enter a word or text string related to the module in the 
	  search text box.</item>
	  <item>Deselect the checkbox for "Courses". Leave the checkbox
	  for "Modules" selected.</item>
	  <item>Click <code>Search</code>. A list of all the modules that 
	  match the search input displays. If more matches occurred than 
	  will fit on one page, then additional pages of matches are listed.
	  </item>
	  <item>Select the checkbox for any module or modules you want
	  to add as content.</item>
	  <item>Click <code>Add selected content</code>.</item>
	</list>
        The titles of the selected modules appear in the course outline 
        under the section you selected.
	</para>
    </section>
    
 <section id="workspacemodulesection">
      <name>Add a Module from Your Workspace or Workgroup</name>
    
      <para id="addfromrep2">
	To add a module from your workspace or workgroup as content in your 
	ourse, use the following steps:
	<list id="copy" type="enumerated">
	  <item>Display the "Contents" tab for your workspace or
	  workgroup that contains the course and the module.</item>
	  <item>Select the checkbox for the desired module. You can add 
	  only modules that are in the "published" state.</item>
	  <item>Click <code>Copy</code>. A message displays that the item 
	  was copied.</item>
	  <item>Click on the course title to access the Course Composer. 
          The <code>Paste</code> button now appears on the "Content" tab 
          along with the <code>Cut</code>, <code>Copy</code>, and 
          <code>Remove</code> buttons.
	  </item>
	  <item>Click on the section title where you want to insert
	  the module.</item>
	  <item>Click <code>Paste</code> on the "Content" tab for the course.</item>
	</list>
        The title of the module appears in the course outline under the section 
        you selected. 
      </para>
      <note>If you try to add a module that is not published, an error 
      message displays. To verify that the module you want to add is 
      published, look in the "State" column in the "Contents" tab of 
      your work area.</note> 
    </section>
    </section>

    <section id="changetitle">
      <name>Provide an Alternate Module Title</name>

      <para id="changetitlepara">
    
	Modules in the Content Commons have titles given to them by
	their authors. These titles may not be appropriate for the
	module when it is used in your course. You can provide the
	module an alternate title that appears in the Roadmap courseview 
	and in the printed versions of your course. The original author's 
	title continues to display when you view the module text. 

	<list id="changetitlelist" type="enumerated">
	  <item>Click the module title in the course outline. The
	  module level "Edit" tab appears on the right side of the
	  screen. </item>
	  <item>Type the new title for the module in the "Alternate
	  Title" field.</item>
          <item>Click <code>Save</code>. </item>
	  </list>
	
	The module title in the course outline changes to the alternate title.
      </para>
    </section>

    <section id="setversion">
      <name>Select the Module Version</name>

      <para id="setversion1para"> 
	When a module is updated or edited, Connexions saves the previous 
	version of the module in history and uses the latest version of the 
	module for viewing. Each new version of a module is given its own 
	version number. You can select which version of each module is used 
	in your course. 

	<list id="versionlist" type="enumerated">
	  <item>Click the module title in the course outline. The
	  module level "Edit" tab appears on the right side of the
	  screen. </item>
	  <item>Select the <code>Version</code> radio button for the 
	  version of the module you want to use in the course. The default is 
	  "Always use newest version". </item>
	  <item>Click <code>Save</code>. </item>
	  </list>
      </para>
    </section>

    <section id="editaddlinkssection">
      <name>Edit or Add Links</name>

     <para id="linkpara1">
        Links allow the viewer to display related information or examples 
        that are not part of the course with the click of a mouse. Links 
        may be defined at the course level or at the individual module level. 
        Any changes you make to the links in an existing module only display 
        with the instance of the module in your course.
</para>

    <section id="editlinkssection">
      <name>Edit Existing Links</name>

      <list id="editlinkslist" type="enumerated">
	<item>Click the module title in the course outline. The
	module "Edit" tab appears on the right side of the screen. </item>
	<item>Click on the "Links" tab. </item>
        <item>Make the desired changes in the "Name", "Link Type", and 
        "Strength" fields in the "Edit Links" panel of the tab. </item>
        <item>Select the checkbox in the "Delete" column for any link 
        you do not want to appear in the module. </item>
        <item>Click <code>Update Links</code>.</item>
      </list>

<para id="editlinkspara">
        The changes are made to the original author's list of links and will 
        appear in the "Links" sidebar when the module is viewed.
      </para>
    </section>

    <section id="addlinkssection">
      <name>Add Links to a Module</name>

      <list id="addlinkslist" type="enumerated">
	<item>Click the module title in the course outline. The
	module "Edit" tab appears on the right side of the screen. </item>
	<item>Click on the "Links" tab. </item>
	<item>To enter a new link, type the link name in the "Enter a Name" 
	field in the "Add a New Link" panel of the tab.</item>
	<item>Select the category of link from the drop-down list next to 
	the "Link Type" field.</item>
	<item>Select the importance of the link from the drop-down
	list next to the "Link Strength" field.</item>
	<item>Enter the target for the link in the "Module ID" or "Link
	URL" field.</item>
	<item>Click <code>Add</code>. </item>
      </list>
      
      <para id="addlinkspara">
        The link will appear in the "Links" sidebar when the module is
        viewed, along with the original author's links, if any.
      </para>
     </section>
    </section>   

    <section id="rearrange">
      <name>Rearrange Contents</name>

     <para id="rearrangepara1">
        The Course Composer has two methods of rearranging the content items 
        within a course. The first method uses up and down arrows to move 
        items around within a course or within a section. The second method 
        uses the <code>Cut</code> and <code>Paste</code> buttons to move 
        items from course to section or from section to section. 
      </para>

         <section id="rearrangeupdown">
           <name>Rearrange with the Up and Down Arrows</name>

         <para id="rearrangepara2">
         To move items around within a course or within a section with 
         the up and down arrows, use the following steps: 

         <list id="rearragelist1" type="enumerated">
	   <item>Select the "Contents" tab in the Course Composer.</item>
	   <item>Click on the course title to rearrange the content items 
	   within the course, or click on a section title to rearrange the 
	   content items within that section. A listing of the contents of 
	   the course or selected section appears on the right side of	
	   the screen.</item>
	<item>Click the up or down arrows in the "Move" column to relocate a 
	content item to a different location within the course or section. 
        The outer two arrows move the content item to the first or last 
        position. The inner two arrows move the content item up or down to 
        the next position.</item>
	 </list>
         </para>
       
      <figure id="coursecomposerfig2">
	<media type="image/png" src="coursecomposerfig2.png"/>
	<caption>"Title" and "Move" columns</caption>
      </figure>
          </section>

         <section id="rearrangecutpaste">
           <name>Rearrange with the Cut and Paste Buttons</name>

         <para id="rearrangepara3">
         To move items from course to section or from section to section 
         with the <code>Cut</code> and <code>Paste</code> buttons, use 
         the following steps: 

          <list id="rearragelist2" type="enumerated">
	    <item>Select the "Contents" tab in the Course Composer.</item>
	    <item>Click on the course title in the course outline to cut 
	    and paste content items within the course, or click on a 
	    section title in the course outline to cut and paste content 
	    items within that section. A listing of the contents of the 
	    course or selected section appears on the right side of the 
	    screen.</item>
	    <item>Select the checkbox to the left of the content item or 
	    items you want to move.</item>
            <item>Click <code>Cut</code>.</item>
            <item>Click on the title of the section in the course outline 
            for the section in which you want to paste the content item.</item>
            <item>Click <code>Paste</code>. The content item or items appear 
            in the course outline under the selected section title and 
            disappear from under the originating course or section title.</item>
	</list>
       </para>
    </section>
    </section>

    <section id="removesection">
      <name>Remove Course Contents</name>
      <para id="removepara1">
         To remove a content item from a course or from a section within 
         a course, use the following steps:

      <list id="removelist" type="enumerated">
	<item>Select the "Contents" tab in the Course Composer.</item>
	<item>Click on the course title to remove a content item from 
	within the course, or click on a section title to remove a content 
	item from within that section. A listing of the contents of that 
	section appears on the right side of
	the screen. </item>
	<item>Select the checkbox for the object to be removed.</item>
	<item>Click <code>Remove</code>.
        The item is removed from the course or section.</item>
      </list>
     </para>
    </section>

     <section id="addroles">
      <name>Assign Roles to Collaborating Authors</name>
       <para id="addrolespara">
        To assign <link src="http://cnx.rice.edu/help/reference/roles">roles</link> 
        to your collaborating authors, use the following steps:

      <list id="addroleslist" type="enumerated">
	<item>Click the "Roles" tab in the Course Composer.</item>
	<item>Type the name for a person who you want to give author, 
	maintainer, or copyright holder role access in the search text box. 
	This person must have a Connexions account. </item>
	<item>Click <code>Search</code>. 
	  A list of those account holders who matched the search string 
	  appears. </item>
	<item>Select the checkbox for the desired collaborator(s).</item>
	<item>Click <code>Add People</code>. 
	  The "Roles Pending Approval" box appears on the bottom of the 
	  screen. </item>
	<item>Select or deselect the appropriate role checkbox for the 
	person.</item>
	<item>Repeat steps 2 through 5 for all the people you want to
	  collaborate on the course with you.</item>
	<item>Click <code>Update Roles</code>. </item>
      </list>
     </para>
      
      <para id="addpeoplepara">
	Connexions notifies the new authors the next time they log in
	that a role request is pending. Once the requests are accepted, 
	the roles are granted and the appropriate access permissions are 
	applied.
      </para>
    </section>   
    
    <section id="notationsection">
      <name>Set Notation Parameters</name>

      <para id="notationpara1">
       Modules in different courses may use different ways of presenting 
       the same items, such as vectors and imaginary numbers. You can select 
       the presentation of these items in your course with the display 
       parameters. To set these parameters for your course, use the 
       following steps: 
     
      <list id="notatlist" type="enumerated">
	<item>Click the "Parameters" tab in the Course Composer.</item>
	<item>Select the radio buttons for the desired notations.
        The defaults appear in the first column.</item>
	<item>Click <code>Update Properties</code>.</item>
      </list>
      </para>

      <para id="notationpara2">Connexions applies the specified notations 
      to the parameter displays of all the modules in the course.</para>
    </section>

    <section id="previewsection">
      <name>Preview the Course</name>

      <para id="previewpara">
	Click the "Preview" tab in the Course Composer to display the
	course on-line, just as a student would view the finished
	course. This preview allows you to verify that the course
	displays as you intended. 
      </para>

    </section>

    <section id="publishcoursesec">
      <name>Publish the Course</name>

      <para id="publishpara">
	A published course is available to anyone on the Internet who
	wants to view it. Once the course is complete, you will
	publish it in Connexions. 

	<list id="publsihlist" type="enumerated">
	  <item>Verify that the metadata entries, roles, and on-line
	  version of the course are as you want them.</item>
	  <item>Click the "Publish" tab in the Course Composer.</item>
	  <item>Type a brief explanation of this revision of the course 
	  in the "Description of Changes" field. This text displays on the 
	  revision history page for the course.</item>
	  <item>Click <code>Publish</code>.</item>
	  </list>
		
          The course is published in Connexions. You may check out the 
          course at any time and revise it with the Course Composer. 
          
          <note type="note">Before Connexions will publish a course, 
          the course must have a person named to the Author, Maintainer, 
          and Copyright Holder roles. In addition, the course can have 
          no pending role requests. All role requests must be either 
          accepted or rejected.</note>
      </para>
    </section>
    
    <section id="existintsection">
      <name>Edit an Existing Course</name>

      <para id="existpara">
	You can edit an existing course with the Course Composer in
	the same way you create a new course. You can edit only
	courses for which you have a maintainer role. To use the 
	Course Composer on an existing course, begin in your workspace 
	or workgroup and use the following steps:

	<list id="existlist" type="enumerated">
	  <item>Click <code>Search for Published Content</code>. 
          The "Search the Connexions repository" screen displays.
	  </item>
    	  <item>Enter a word or text string related to the course in the 
    	  search text box.</item>
	  <item>Deselect the checkbox for "Modules". Leave the checkbox
	  for "Courses" selected.</item>
	  <item>Click <code>Search</code>. A list of the objects that 
	  match the search string displays.</item>
	  <item>Select the checkbox for the desired course</item>
	  <item>Select the workspace or workgroup where the course
	  will be placed from the "Add selected content to" drop-down
	  list</item>
	  <item>Click <code>Add</code>. The course is added to the 
	  specified workspace or workgroup.</item>
	  <item>Open the course in the Course Composer and edit as
	  described under the <cnxn target="create">Create a New 
	  Course</cnxn> heading earlier in this section.</item>
	</list>
      </para>
    </section>
   
	    
	  
  </content>
  
</document>
