From 8bb4b034068f9ee8b503c40e725c61d24442bdf4 Mon Sep 17 00:00:00 2001 From: Mark Hoeber Date: Wed, 11 Feb 2015 15:09:48 -0500 Subject: [PATCH] Fixed shared image paths --- .../building_course/provide_overview.rst | 466 +----------------- .../source/creating_content/libraries.rst | 390 +-------------- .../ContentLibraries_AdvancedSetting.png | Bin .../ContentLibraries_ComponentUpdateNow.png | Bin .../ContentLibraries_ResetComponentField.png | Bin .../ContentLibraries_SelectProblemType.png | Bin .../Images/ContentLibraries_ViewMatching.png | Bin .../Images/ContentLibraryID.png | Bin .../Images/ContentLibrary_EditName.png | Bin .../Images/ContentLibrary_NewCL.png | Bin .../Images/EntEx_CourseAccordionAfterPass.png | Bin .../Images/EntEx_LandingPage.png | Bin .../Images/PrereqAboutPage.png | Bin .../Images/Prereq_StudentDashboard.png | Bin .../ResetRandomizedComponentSetting copy.png | Bin .../Images/SFD_SN_NotesTab.png | Bin .../Images/SFD_SN_bodyexample.png | Bin .../Images/google-advanced-setting.png | Bin .../Images/google-calendar-address.png | Bin .../Images/google-calendar-edit.png | Bin .../Images/google-calendar-settings.png | Bin .../Images/google-calendar-studio.png | Bin .../Images/google-calendar.png | Bin .../Images/google-components.png | Bin .../Images/google-document-edit-studio.png | Bin .../Images/google-document-studio.png | Bin .../Images/google-embed.png | Bin .../Images/google-presentation.png | Bin .../Images/google-publish-to-web.png | Bin .../Images/google-spreadsheet.png | Bin .../building_course/creating_new_course.rst | 6 +- .../building_course/provide_overview.rst | 465 +++++++++++++++++ .../creating_content/libraries.rst | 389 +++++++++++++++ .../developing_course/course_components.rst | 24 +- .../developing_course/course_outline.rst | 28 +- .../developing_course/workflow.rst | 4 +- .../running_course/course_grades.rst | 24 +- .../exercises_tools/google_calendar.rst | 12 +- en_us/shared/exercises_tools/google_docs.rst | 12 +- .../randomized_content_blocks.rst | 12 +- .../shared/exercises_tools/student_notes.rst | 4 +- 41 files changed, 919 insertions(+), 917 deletions(-) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/ContentLibraries_AdvancedSetting.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/ContentLibraries_ComponentUpdateNow.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/ContentLibraries_ResetComponentField.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/ContentLibraries_SelectProblemType.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/ContentLibraries_ViewMatching.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/ContentLibraryID.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/ContentLibrary_EditName.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/ContentLibrary_NewCL.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/EntEx_CourseAccordionAfterPass.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/EntEx_LandingPage.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/PrereqAboutPage.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/Prereq_StudentDashboard.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/ResetRandomizedComponentSetting copy.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/SFD_SN_NotesTab.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/SFD_SN_bodyexample.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/google-advanced-setting.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/google-calendar-address.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/google-calendar-edit.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/google-calendar-settings.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/google-calendar-studio.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/google-calendar.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/google-components.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/google-document-edit-studio.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/google-document-studio.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/google-embed.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/google-presentation.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/google-publish-to-web.png (100%) rename en_us/{course_authors/source => shared/building_and_running_chapters}/Images/google-spreadsheet.png (100%) create mode 100644 en_us/shared/building_and_running_chapters/building_course/provide_overview.rst create mode 100644 en_us/shared/building_and_running_chapters/creating_content/libraries.rst diff --git a/en_us/course_authors/source/building_course/provide_overview.rst b/en_us/course_authors/source/building_course/provide_overview.rst index 27fa3613d4..d0fc363f70 100644 --- a/en_us/course_authors/source/building_course/provide_overview.rst +++ b/en_us/course_authors/source/building_course/provide_overview.rst @@ -1,465 +1 @@ -.. _Providing a Course Overview: - -##################################### -Providing a Course Overview -##################################### - - -********** -Overview -********** - -Prospective students need to know specific information about your course, -including what the course covers, how much time they should plan to spend on the -course each week, and whether the course requires any prior skills and -knowledge. You specify all of this information in Studio. - -For more information, see the following topics: - -* :ref:`Describe Your Course` -* :ref:`Add a Course Image` -* :ref:`Add a Course Video` -* :ref:`Set Course Time Requirements` -* :ref:`Set Course Prerequisites` -* :ref:`Set Important Dates for Your Course` - -Most of this information appears on the course About page, sometimes called the -course summary page. The following image shows a typical About page. - -.. image:: ../Images/about_page.png - :width: 600 - :alt: An image of the course About page showing the course start and end dates, - prerequisites, description, and other information - -Students see the course About page before they enroll in the course. After a -student enrolls in the course, students can see information about your course on -the Student Dashboard. - -.. image:: ../Images/dashboard.png - :width: 600 - :alt: An image of the dashboard showing courses with start and end dates - -.. note:: If your course will be available on edX.org, you must work with - your edX program manager to prepare the content for your About page, including - the course overview, image, and video. For more information, see the `About - page lesson `_ in `edX101 `_. - - -.. _Describe Your Course: - -********************************* -Describe Your Course -********************************* - -You describe your course in a course overview. The overview contains important -information for students who may be interested in taking your course. It -introduces the main idea of the course and describes the topics or concepts that -the course covers. The overview can also describe the skills and knowledge your -students need to be able to succeed in your course, as well as provide -information about course requirements and staff. - -The course overview is outlined in the following course About page. - -.. image:: ../Images/about-page-course-description.png - :width: 600 - :alt: Image of a course About page with the overview circled - -You use HTML to enter the course overview in Studio. The **Course Overview** -field in Studio contains a boilerplate that includes placeholders. - -To enter the course overview, follow these steps. - -#. From the **Settings** menu, select **Schedule & Details**. -#. Scroll down to the **Introducing Your Course** section, then locate the - **Course Overview** field. - - .. image:: ../Images/course_overview.png - :width: 600 - :alt: Image of the HTML course description. - -3. Replace the placeholders in the boilerplate text to create your course overview. - Studio automatically saves your changes. - - .. note:: Do not edit HTML tags in the boilerplate. These tags align - the content on the course About page. - -4. Below the **Course Overview** field, click **your course summary page** to - see how the description will appear to students. A sample About page opens in - a new window. - - When you make changes, note that you may have to wait a moment for the content to auto-save before the changes appear on the page. - - -.. _Add a Course Image: - -************************ -Add a Course Image -************************ - -You provide a course image that identifies your course. The course image that -you add in Studio appears on the student dashboard. On Edge, the course image -also appears on the course About page. - -.. image:: ../Images/dashboard-course-image.png - :width: 600 - :alt: Image of the course image in the student dashboard - -The course image must be a minimum of 660 pixels in width by 240 pixels in -height, and in .jpg or .png format. - -To add a course image, follow these steps. - -#. From the **Settings** menu, select **Schedule & Details**. -#. Scroll down to the **Course Image** section. -#. To select an image from your computer, click **Upload Course Image**, then - follow the prompts to find and upload your image. -#. View your dashboard to see how the image will appear to students. - -.. _Add a Course Video: - -********************************* -Add a Course Introduction Video -********************************* - -To excite and entice potential students to enroll, each course can have a course -introduction video. The video should reveal some of the personality the -instructors bring to the course. - -.. image:: ../Images/about-page-course-video.png - :alt: Image of the course video in the course About page. - -The video should answer these key questions. - -* Who is teaching the course? -* What university or college is the course affiliated with? -* What topics and concepts does your course cover? -* Why should a learner enroll in your course? - -The video should deliver your message as concisely as possible and have a run -time of less than 2 minutes. - -Ensure your course introduction video follows the same :ref:`Compression -Specifications` and :ref:`Video Formats` guidelines as course content videos. - -To add a course introduction video: - - -#. Upload the course video to YouTube. Make note of the code that appears - between **watch?v =** and **&feature** in the URL. This code appears in the - box below. - - .. image:: ../Images/image127.png - :alt: Image of a sample course video - -2. From the **Settings** menu, select **Schedule & Details**. -#. Scroll down to the **Course Introduction Video** section. -#. In the field below the video box, enter the YouTube video ID (the code you - copied in step 1). When you add the code, the video automatically loads in - the video box. Studio automatically saves your changes. - - -.. _Set Course Time Requirements: - -************************************ -Set Course Time Requirements -************************************ - -To specify the number of hours that you expect students to spend on the course -each week, follow these steps. - -#. From the **Settings** menu, select **Schedule & Details**. -#. Scroll down to the **Requirements** section. -#. In the **Hours of Effort per Week** field, enter the number of hours you - expect students to work on this course each week. -#. View your course About page to see how the requirements will appear to - students. - - -.. _Set Course Prerequisites: - -******************************************** -Set Course Prerequisites -******************************************** - -You might want to make sure that your students have a specific set of skills and -knowledge before they take your course. In addition to suggesting general -requirements in your course overview, you can require students to :ref:`complete -specific prerequisite courses`, or :ref:`take an -entrance exam`, or both. - - -.. _Specify Prerequisite Courses: - -=================================== -Specify Prerequisite Courses -=================================== - -You can require that your students pass a particular edX course before they -enroll in your course. Students see information about course prerequisites on -the course About page. - -.. image:: ../Images/PrereqAboutPage.png - :width: 500 - :alt: A course About page with prerequisite course information circled - -If students have not completed the prerequisite course, they can enroll in your -course and then see your course on the Student Dashboard. However, unlike with -other courses, the Student Dashboard does not provide a link to the courseware. -The Student Dashboard includes a link to the About page for the prerequisite -course. Students can enroll in the prerequisite course from the About page. - -.. image:: ../Images/Prereq_StudentDashboard.png - :width: 500 - :alt: The Student Dashboard with an available course and a course that is - unavailable because it has a prerequisite - -To specify a prerequisite course, you must be a course author in both the -current course and in the prerequisite course. - -#. In Studio, open your course. -#. On the **Settings** menu, select **Schedule & Details**. -#. On the **Schedule & Details** page, scroll to the **Requirements** section. -#. Under **Prerequisite Course**, click the drop-down list to select a course. -#. At the bottom of the page, select **Save Changes**. - -.. note:: Currently, you can specify only one prerequisite course. - - -.. _Require an Entrance Exam: - -=================================== -Require an Entrance Exam -=================================== - -You can require your students to pass an entrance exam before they access your -course materials. If you include an entrance exam, students who enroll in your -course see only the **Course Updates & News** page and an **Entrance Exam** tab -until they pass the exam. - -.. image:: ../Images/EntEx_LandingPage.png - :width: 500 - :alt: The Course Updates & News page with the Entrance Exam tab circled on the - left - - -After students pass the exam, they can access all released materials in your -course. - -To require an entrance exam, follow these steps. - -#. In Studio, open your course. -#. On the **Settings** menu, select **Schedule & Details**. -#. On the **Schedule & Details** page, scroll to the **Requirements** section. -#. Select the **Require students to pass an exam before accessing course - materials** check box. -#. At the bottom of the page, select **Save Changes**. - -After you save your changes, Studio automatically creates an **Entrance Exam** -section in your course outline. To add content to your entrance exam, go to the -course outline. - -Best Practices for Entrance Exams -******************************************** - -We strongly recommend that you follow several guidelines to help you and your -students have a positive experience with entrance exams. - -* Make sure that your beta testers include the entrance exam when they test your - other course content. - -* Make sure that you mention the entrance exam in the course description on your - course About page. Otherwise, students will not know about the entrance exam - before they enroll in your course and try to access course content. - -* Add an anouncement at the top of the **Course Updates & News** page that - contains information and instructions for students who need to take the exam. - When students first try to access content in a course that has an entrance - exam, they see the **Course Updates & News** page. We suggest that you include - the following information. - - * To begin the course entrance exam, students click the **Entrance Exam** tab - on the left side of the screen. - - * After students complete the entrance exam, they have to click the **Entrance - Exam** tab again or refresh the page in their browser. When the page - refreshes, students can see all currently available course content. - - .. image:: ../Images/EntEx_CourseAccordionAfterPass.png - :width: 500 - :alt: The student view after the student has passed the entrance exam, - with all available course sections listed in the course accordion - - -Create an Entrance Exam from the Course Outline -************************************************** - -You create your course entrance exam from the course outline in Studio. Creating -entrance exam content is just like creating other course content. For more -information, see :ref:`Creating Course Content Index`. - -Adjust Scores in the Entrance Exam -******************************************** - -If you find an error in the exam after students have taken it, and corrections -to the exam are unavoidable, you have several options to rescore the exam for -individual students. These options are available on the Instructor Dashboard. - -On the Instructor Dashboard, click **Student Admin**, and then scroll to the -**Entrance Exam Grade Adjustment** section. The following options are available. - -* **Reset Student Attempts**: Reset the value for one particular student's - attempts back to zero so that the student can begin work over again. For more - information, see :ref:`reset_attempts`. - -* **Rescore Student Submission**: Rescore the responses that a student has - submitted. For more information, see :ref:`rescore`. - -* **Delete Student State for Problem**: Delete a student's entire history for - the exam from the database. For more information, see :ref:`delete_state`. - -Another option on the Instructor Dashboard is **Show Background Task History for -Student**. If you reset student attempts, rescore student submissions, or delete -student state, the operation runs in the background. If you want to see a record -of all the operations that have run for the entrance exam, select **Show -Background Task History for Student**. - - - -.. _Set Important Dates for Your Course: - -*********************************** -Set Important Dates for Your Course -*********************************** - -You must set dates and times for enrollment and for the course. - -#. In Studio, from the **Settings** menu, select **Schedule and Details**. -#. Follow the on-screen text to enter the course and enrollment schedule. - - .. image:: ../Images/schedule.png - :width: 450 - :alt: An image of the course schedule page. - - -.. note:: The **Time** fields on this page, and the times that students - see, use Universal Coordinated Time (UTC). - -.. _The Course Start Date: - -======================= -The Course Start Date -======================= - - -.. note:: The default course start date is set far into the future, to - **01/01/2030**. This is to ensure that your course does not start before - you intend it to. You must change the course start date to the date you want - students to begin using the course. - -Students see the course start date and time on their **Current Courses** -dashboards and on the course About page. Students can see some parts of the -course before the course start date. For example, students can see your **Course -Info** page and course-wide discussion topics as soon as they enroll in your -course. For more information about course-wide discussion topics, see -:ref:`Create CourseWide Discussion Topics`. - -The following example shows the course start date and time on the course About -page: - -.. image:: ../Images/about-page-course-start.png - :width: 600 - :alt: An image of the course About page, with the start date circled. - -In the dashboard, students see the start dates and times for each of their -courses, as in the following examples. - -.. image:: ../Images/dashboard-course-to-start.png - :width: 600 - :alt: An image of two courses in the student dashboard, with the start dates - and times circled. - -.. note:: If you do not specify a start time for your course, students see - the default start time, 00:00 Coordinated Universal Time (UTC). - - -.. _Set the Advertised Start Date: - -====================================== -Set the Advertised Start Date -====================================== - -You can set an advertised start date for your course that is different than the -course start date you set in the **Schedule and Details** page. You may want to -do this if there is uncertainty about the exact start date. For example, you -could advertise the start date as **Spring, 2014**. - -To set an advertised start date: - -#. From the **Settings** menu, select **Advanced Settings**. -#. Find the **Course Advertised Start Date** policy key. The default value is - **null**. -#. Enter the value you want to display as the advertised start date. You can - use any string, enclosed in double quotation marks. If you format the string - as a date (for example, as 02/01/2014), the value is parsed and presented to - students as a date. - - .. image:: ../Images/advertised_start.png - :alt: Image of the advertised start date policy key with a value of "anytime, - self-paced" - -4. Click **Save Changes** at the bottom of the page. - -The start date shown on the dashboard is now the value of the **Course -Advertised Start Date** policy key: - -.. image:: ../Images/dashboard-course_adver_start.png - :width: 600 - :alt: An image of a course listing in the student dashboard, with the - advertised start date circled. - -If you do not change the default course start date (01/01/2030), and the -**Course Advertised Start Date** policy value is ``null``, then the student -dashboard does not list a start date for the course. Students just see that -the course has not yet started. - -.. _The Course End Date: - -===================== -The Course End Date -===================== - -The course end date is the date after which students can no longer earn credit -toward certificates. Students who have earned certificates can view them after -the course end date. - -.. important:: - If you do not set a course end date, students will not be able to access - earned certificates. - -After grades and certificates are finalized, students see the course end date -on their personal **Current Courses** dashboards, as shown in the following -examples. - -* If grades and certificates are not yet finalized, students can see the course - end date and a message: - - .. image:: ../Images/dashboard-wrapping-course.png - :alt: Image of a course on the student dashboard that has ended, but not - been graded - -* When grades and certificates are finalized, students who have not earned a - certificate see their score and the score required to earn a certificate: - - .. image:: ../Images/dashboard-no-cert-course.png - :alt: Image of a course on the student dashboard that has ended, but not - been graded - -* Students whose final score is equal to or higher than the required score can - click **Download Certificate** to get their certificates as PDFs: - - .. image:: ../Images/dashboard-completed-course.png - :alt: Image of a course on the student dashboard that has ended, but not - been graded - +.. include:: ../../../shared/building_and_running_chapters/building_course/provide_overview.rst diff --git a/en_us/course_authors/source/creating_content/libraries.rst b/en_us/course_authors/source/creating_content/libraries.rst index 1a08558f19..4038cca253 100644 --- a/en_us/course_authors/source/creating_content/libraries.rst +++ b/en_us/course_authors/source/creating_content/libraries.rst @@ -1,389 +1 @@ -.. _Content Libraries: - -############################## -Working with Content Libraries -############################## - - -.. _ Content Libraries Overview: - -************************** -Content Libraries Overview -************************** - -In Studio, if you have course creation privileges, you can create a content -library to build a pool of components that can be used in randomized assignments -in your courses. You can add HTML components, problems, and video components to -a library. Peer assessment and discussion components are not supported in -content libraries. - -.. note:: Content libraries are available only for courses that have course - identifiers in this format: ``{key type}:{org}+{course}+{run}``. For example, ``course-v1:edX+DemoX+Demo_2015``. Your course identifier appears in the browser address bar as the final part of the URL when you open your course in Studio. For more details, see :ref:`Create a New Course`. - -After creating a library and adding components to it, if you have :ref:`enabled -content libraries` in your course, you can use these -library components in randomized assignments in your course. You do this by -adding a randomized content block to a course unit and indicating one or more -libraries from which the randomized content is to drawn, as well as the number -and type of problems that each student is assigned. If you specify more than one -library from which to randomly draw components for the randomized assignment, -the content from all specified libraries is combined before the random selection -is made. - -Libraries have separate users and levels of access from courses. Initially, only -the person who created the library has access. She can add other users to the -library. For details, see :ref:`Give Other Users Access to Your Library`. The -libraries that you create or have access to are listed on the **Libraries** tab -on the Studio Home page. - -See the following sections for details about creating and managing content -libraries. - -* :ref:`Enable Content Libraries` -* :ref:`Create a New Library` -* :ref:`Add Components to a Library` -* :ref:`View the Contents of a Library` -* :ref:`Edit Components in a Library` -* :ref:`Give Other Users Access to Your Library` - -See the following sections for details about using content library components in -a course. - -* :ref:`Use Components from Libraries in a Course` -* :ref:`Add a Randomized Content Block to Your Course` -* :ref:`View the Matching Components in a Randomized Content Block` -* :ref:`Edit Components in Randomized Content Blocks` -* :ref:`Get the Latest Version of Library Content` - - -.. _Create a New Library: - -******************** -Create a New Library -******************** - -Use :ref:`content libraries` to build a pool of components -that can be used in randomized assignments in your courses. You can create -content libraries if you have course creation privileges. - -For information about adding other users to a library after you create it, see -:ref:`Give Other Users Access to Your Library`. - -To create a new content library, follow these steps. - -#. Log in to Studio. - -#. Click **New Library**. -#. Enter the required information for your new library, then click **Create**. - - .. note:: Enter new library information carefully. The values in these - fields become part of the URL for your library, therefore the total number - of characters in the **Library Name**, **Organization**, and **Library - Code** fields must be 65 or fewer. - - .. image:: ../Images/ContentLibrary_NewCL.png - :alt: Image of the library creation page - - - * For **Library Name**, enter the public display name for your library. Choose - a meaningful name that will help you and other course team members to - identify the contents of the library. For example, "Level 200 Math - Problems". - - * For **Organization**, enter the identifier for your university. For - example, enter HarvardX or MITx. Do not include spaces or special - characters. - - * For **Library Code**, enter an identifier for your library that is unique - within your organization. This code becomes part of the URL for your - library, so do not include spaces or special characters in the code. - - -4. Click **Create**. - -You see the new library, to which you can now add components. For details about -adding components to a library, see :ref:`Add Components to a Library`. - -The system-generated Library ID for the new library appears in the sidebar. - - .. image:: ../Images/ContentLibraryID.png - :alt: The Library ID for the new library is shown the sidebar - -.. note:: Copy or make a note of the Library ID for the new library. When you - add a randomized content block to a course unit, you use the Library ID to - specify this library as a source for the randomized content. - - -.. _Edit a Library: - -************** -Edit a Library -************** - -After you create a library, the only change you can make to the initial library -information is to the name. However, at any time, you can make changes to the -components in your library, including adding or deleting components or editing -the settings of components. For details about editing the contents of a library, -see :ref:`Edit Components in a Library` and :ref:`Add Components to a Library`. - - -To change the name of a library, follow these steps. - -#. Log in to Studio. -#. Click **Libraries**, then click the library whose name you want to edit. - -#. Click the **Edit** icon next to the library name. - - The library name field becomes editable. - - .. image:: ../Images/ContentLibrary_EditName.png - :alt: The Edit icon to the right of the Library Name - -4. In the library name field, make edits or enter a new library name. -#. Click anywhere outside the library name field to save your changes. - - -For details about giving other users access to the library, see :ref:`Give Other -Users Access to Your Library`. - - -.. _Add Components to a Library: - -**************************** -Add Components to a Library -**************************** - -To add new :ref:`components` to your library, follow these -steps. - -#. Log in to Studio. -#. Click **Libraries**, then click the library that you want to add components to. - -#. Click **Add Component**, then click the component type that you want to add - under **Add New Component**. - -For more information about the types of components you can add to a library, see -these topics. - -* :ref:`Working with HTML Components` -* :ref:`Working with Problem Components` -* :ref:`Working with Video Components` - -After you add a component to a library, you can edit its settings. These -settings are retained when the component is selected from the library and used -in a course. - -When a component from the library is used in a randomized content block, you can -further edit the component as it exists in the unit, without affecting the -original version in the library. For details, refer to :ref:`Edit Components in -a Library` and :ref:`Get the Latest Version of Library Content`. - - -.. _View the Contents of a Library: - -****************************** -View the Contents of a Library -****************************** - -To view the entire contents of a library in Studio, follow these steps. - -#. Log in to Studio. -#. Click **Libraries**, then click the library whose components you want to - view. - -The components in the library display in the order in which they were added, -with the most recently added at the bottom. If your library has more than 10 -components, additional components are shown on other pages. - -The range of the components shown on the current page, and the total number of -components, are shown at the top of the page. - -You can navigate through the pages in these ways: - -* Use the **<** and **>** buttons at the top and bottom of the list to navigate - to the previous and next pages. - -* At the bottom of the page, you can edit the first number in the page range. - Click the number to place your cursor in the field, then enter the page number - you want to jump to. - - .. image:: ../Images/file_pagination.png - :alt: Image showing a pair of page numbers with the first number circled - -To view the list of matching components in the library, see :ref:`View the Matching Components in a Randomized Content Block`. - -To view the randomized content as a student would see it, see :ref:`View the -Randomized Content as a Student`. - - -.. _Edit Components in a Library: - -**************************** -Edit Components in a Library -**************************** - -After you have added components to a content library, you can edit, duplicate, -or delete them. - -For step-by-step instructions for editing, duplicating, or -deleting components, refer to the following topics: - -* :ref:`Edit a Component` -* :ref:`Duplicate a Component` -* :ref:`Delete a Component` - -.. note:: If you modify components in your library that are in use in a course, - these updates in the "source" library are not reflected in the course unless - you manually update the randomized content block in the course unit. For - details about updating library components used in your course to match the - latest version in the content library, see :ref:`Get the Latest Version of - Library Content`. - - -.. _Delete a Library: - -***************** -Delete a Library -***************** - -You cannot delete a library. Instead, you can discontinue use of an unwanted -library. To do so, first make sure that none of its components are in use in any -courses, then delete all components in the library. You can also :ref:`edit the -name of the library` to make it clear to other course staff that -the library should not be used as a source of randomized assignment content in -courses. - -For details about deleting components in a library, see :ref:`Edit Components in -a Library`. - - -.. _Give Other Users Access to Your Library: - -*************************************** -Give Other Users Access to Your Library -*************************************** - -When you create a library, you are automatically assigned an Admin role in that -library. - -You can give other Studio users access to your library. Depending on the level -of access that you give them in the library, additional library users can view -and use library content in courses, edit library content, or add and manage -other library users. All users to whom you give library access must be -registered with Studio and have an active account. - -These are the levels of access for libraries: - -* **User** -- Users can view library content and can use library components in - their courses, but they cannot edit the contents of a library. - -* **Staff** -- Staff can use library components in their courses. In addition, - as content co-authors, they have full editing privileges in a library. - -* **Admin** -- Admins have full editing privileges for a library. In addition, - they can add and remove other team members from library access. There must be at - least one user with Admin privileges in a library. - -.. note:: The levels of access for libraries are hierarchical. You can add new - library members only with the **User** level of access, after which you can - give them the **Staff** level of access. You can give the **Admin** level of - access only to people who already have the **Staff** level of access. - - -========================= -Add a User to the Library -========================= - -To grant a user initial **User** access to a library, follow these steps. - -.. note:: Only library users with the **Admin** level of access can add users to - the library. - -#. Ensure that the new library member has an active Studio account. -#. On the Studio home page, click the **Libraries** tab and locate the library - to which you are adding this user. -#. From the **Settings** menu select **User Access**. -#. On the **User Access** page, click **Add a New User**. -#. Enter the new user's email address, then click **ADD USER**. - - The new user is added to the list of library members with the **User** level - of access. - - -============================== -Remove a User from the Library -============================== - -You can remove users from the library at any time, regardless of the level of -access that they have. - -To remove a user from the library, follow these steps. - -#. In Studio, click the **Libraries** tab and locate your library. -#. From the **Settings** menu select **User Access**. - -#. On the **User Access** page, locate the user that you want to remove. -#. Hover over the user's box and click the trash can icon. - - You are prompted to confirm the deletion. - -5. Click **Delete**. - - The user is removed from the library. - - -========================= -Add Staff or Admin Access -========================= - -The levels of access for libraries are hierarchical. You can add new library -members only with the **User** level of access, after which you can give them -the **Staff** level of access. You can give the **Admin** level of access only -to people who already have the **Staff** level of access. - -To give a library member a higher level of access to the library, follow these -steps. - - -#. In Studio, click the **Libraries** tab and locate your library. -#. From the **Settings** menu select **User Access**. - -#. On the **User Access** page, locate the user to whom you are giving - additional privileges. - - - If he currently has **User** access, click **Add Staff Access**. - - If he currently has **Staff** access, click **Add Admin Access**. - - The user's display listing is updated to indicate the new level of access. In - addition, their listing now includes a button to remove their current level of - access and move them back to their previous level of access. For details about - reducing a user's level of access to a library, see :ref:`Remove Staff or - Admin Access`. - - -.. _Remove Staff or Admin Access: - -============================ -Remove Staff or Admin Access -============================ - -After you have granted users **Staff** or **Admin** access, you (or other -**Admin** library users) can reduce their levels of access. - -To remove **Staff** or **Admin** access from a library user, follow these steps. - -#. In Studio, click the **Libraries** tab and locate your library. -#. From the **Settings** menu select **User Access**. - -#. On the **User Access** page, locate the user whose access level you are - changing. - - - If she currently has **Staff** access, click **Remove Staff Access**. - - If she currently has **Admin** access, click **Remove Admin Access**. - - The user's display listing is updated to indicate their new role. - -.. note:: There must always be at least one Admin for a library. If there is - only one user with the Admin role, you cannot remove him or her from the - Admin role unless you first assign another user to the Admin role. - +.. include:: ../../../shared/building_and_running_chapters/creating_content/libraries.rst diff --git a/en_us/course_authors/source/Images/ContentLibraries_AdvancedSetting.png b/en_us/shared/building_and_running_chapters/Images/ContentLibraries_AdvancedSetting.png similarity index 100% rename from en_us/course_authors/source/Images/ContentLibraries_AdvancedSetting.png rename to en_us/shared/building_and_running_chapters/Images/ContentLibraries_AdvancedSetting.png diff --git a/en_us/course_authors/source/Images/ContentLibraries_ComponentUpdateNow.png b/en_us/shared/building_and_running_chapters/Images/ContentLibraries_ComponentUpdateNow.png similarity index 100% rename from en_us/course_authors/source/Images/ContentLibraries_ComponentUpdateNow.png rename to en_us/shared/building_and_running_chapters/Images/ContentLibraries_ComponentUpdateNow.png diff --git a/en_us/course_authors/source/Images/ContentLibraries_ResetComponentField.png b/en_us/shared/building_and_running_chapters/Images/ContentLibraries_ResetComponentField.png similarity index 100% rename from en_us/course_authors/source/Images/ContentLibraries_ResetComponentField.png rename to en_us/shared/building_and_running_chapters/Images/ContentLibraries_ResetComponentField.png diff --git a/en_us/course_authors/source/Images/ContentLibraries_SelectProblemType.png b/en_us/shared/building_and_running_chapters/Images/ContentLibraries_SelectProblemType.png similarity index 100% rename from en_us/course_authors/source/Images/ContentLibraries_SelectProblemType.png rename to en_us/shared/building_and_running_chapters/Images/ContentLibraries_SelectProblemType.png diff --git a/en_us/course_authors/source/Images/ContentLibraries_ViewMatching.png b/en_us/shared/building_and_running_chapters/Images/ContentLibraries_ViewMatching.png similarity index 100% rename from en_us/course_authors/source/Images/ContentLibraries_ViewMatching.png rename to en_us/shared/building_and_running_chapters/Images/ContentLibraries_ViewMatching.png diff --git a/en_us/course_authors/source/Images/ContentLibraryID.png b/en_us/shared/building_and_running_chapters/Images/ContentLibraryID.png similarity index 100% rename from en_us/course_authors/source/Images/ContentLibraryID.png rename to en_us/shared/building_and_running_chapters/Images/ContentLibraryID.png diff --git a/en_us/course_authors/source/Images/ContentLibrary_EditName.png b/en_us/shared/building_and_running_chapters/Images/ContentLibrary_EditName.png similarity index 100% rename from en_us/course_authors/source/Images/ContentLibrary_EditName.png rename to en_us/shared/building_and_running_chapters/Images/ContentLibrary_EditName.png diff --git a/en_us/course_authors/source/Images/ContentLibrary_NewCL.png b/en_us/shared/building_and_running_chapters/Images/ContentLibrary_NewCL.png similarity index 100% rename from en_us/course_authors/source/Images/ContentLibrary_NewCL.png rename to en_us/shared/building_and_running_chapters/Images/ContentLibrary_NewCL.png diff --git a/en_us/course_authors/source/Images/EntEx_CourseAccordionAfterPass.png b/en_us/shared/building_and_running_chapters/Images/EntEx_CourseAccordionAfterPass.png similarity index 100% rename from en_us/course_authors/source/Images/EntEx_CourseAccordionAfterPass.png rename to en_us/shared/building_and_running_chapters/Images/EntEx_CourseAccordionAfterPass.png diff --git a/en_us/course_authors/source/Images/EntEx_LandingPage.png b/en_us/shared/building_and_running_chapters/Images/EntEx_LandingPage.png similarity index 100% rename from en_us/course_authors/source/Images/EntEx_LandingPage.png rename to en_us/shared/building_and_running_chapters/Images/EntEx_LandingPage.png diff --git a/en_us/course_authors/source/Images/PrereqAboutPage.png b/en_us/shared/building_and_running_chapters/Images/PrereqAboutPage.png similarity index 100% rename from en_us/course_authors/source/Images/PrereqAboutPage.png rename to en_us/shared/building_and_running_chapters/Images/PrereqAboutPage.png diff --git a/en_us/course_authors/source/Images/Prereq_StudentDashboard.png b/en_us/shared/building_and_running_chapters/Images/Prereq_StudentDashboard.png similarity index 100% rename from en_us/course_authors/source/Images/Prereq_StudentDashboard.png rename to en_us/shared/building_and_running_chapters/Images/Prereq_StudentDashboard.png diff --git a/en_us/course_authors/source/Images/ResetRandomizedComponentSetting copy.png b/en_us/shared/building_and_running_chapters/Images/ResetRandomizedComponentSetting copy.png similarity index 100% rename from en_us/course_authors/source/Images/ResetRandomizedComponentSetting copy.png rename to en_us/shared/building_and_running_chapters/Images/ResetRandomizedComponentSetting copy.png diff --git a/en_us/course_authors/source/Images/SFD_SN_NotesTab.png b/en_us/shared/building_and_running_chapters/Images/SFD_SN_NotesTab.png similarity index 100% rename from en_us/course_authors/source/Images/SFD_SN_NotesTab.png rename to en_us/shared/building_and_running_chapters/Images/SFD_SN_NotesTab.png diff --git a/en_us/course_authors/source/Images/SFD_SN_bodyexample.png b/en_us/shared/building_and_running_chapters/Images/SFD_SN_bodyexample.png similarity index 100% rename from en_us/course_authors/source/Images/SFD_SN_bodyexample.png rename to en_us/shared/building_and_running_chapters/Images/SFD_SN_bodyexample.png diff --git a/en_us/course_authors/source/Images/google-advanced-setting.png b/en_us/shared/building_and_running_chapters/Images/google-advanced-setting.png similarity index 100% rename from en_us/course_authors/source/Images/google-advanced-setting.png rename to en_us/shared/building_and_running_chapters/Images/google-advanced-setting.png diff --git a/en_us/course_authors/source/Images/google-calendar-address.png b/en_us/shared/building_and_running_chapters/Images/google-calendar-address.png similarity index 100% rename from en_us/course_authors/source/Images/google-calendar-address.png rename to en_us/shared/building_and_running_chapters/Images/google-calendar-address.png diff --git a/en_us/course_authors/source/Images/google-calendar-edit.png b/en_us/shared/building_and_running_chapters/Images/google-calendar-edit.png similarity index 100% rename from en_us/course_authors/source/Images/google-calendar-edit.png rename to en_us/shared/building_and_running_chapters/Images/google-calendar-edit.png diff --git a/en_us/course_authors/source/Images/google-calendar-settings.png b/en_us/shared/building_and_running_chapters/Images/google-calendar-settings.png similarity index 100% rename from en_us/course_authors/source/Images/google-calendar-settings.png rename to en_us/shared/building_and_running_chapters/Images/google-calendar-settings.png diff --git a/en_us/course_authors/source/Images/google-calendar-studio.png b/en_us/shared/building_and_running_chapters/Images/google-calendar-studio.png similarity index 100% rename from en_us/course_authors/source/Images/google-calendar-studio.png rename to en_us/shared/building_and_running_chapters/Images/google-calendar-studio.png diff --git a/en_us/course_authors/source/Images/google-calendar.png b/en_us/shared/building_and_running_chapters/Images/google-calendar.png similarity index 100% rename from en_us/course_authors/source/Images/google-calendar.png rename to en_us/shared/building_and_running_chapters/Images/google-calendar.png diff --git a/en_us/course_authors/source/Images/google-components.png b/en_us/shared/building_and_running_chapters/Images/google-components.png similarity index 100% rename from en_us/course_authors/source/Images/google-components.png rename to en_us/shared/building_and_running_chapters/Images/google-components.png diff --git a/en_us/course_authors/source/Images/google-document-edit-studio.png b/en_us/shared/building_and_running_chapters/Images/google-document-edit-studio.png similarity index 100% rename from en_us/course_authors/source/Images/google-document-edit-studio.png rename to en_us/shared/building_and_running_chapters/Images/google-document-edit-studio.png diff --git a/en_us/course_authors/source/Images/google-document-studio.png b/en_us/shared/building_and_running_chapters/Images/google-document-studio.png similarity index 100% rename from en_us/course_authors/source/Images/google-document-studio.png rename to en_us/shared/building_and_running_chapters/Images/google-document-studio.png diff --git a/en_us/course_authors/source/Images/google-embed.png b/en_us/shared/building_and_running_chapters/Images/google-embed.png similarity index 100% rename from en_us/course_authors/source/Images/google-embed.png rename to en_us/shared/building_and_running_chapters/Images/google-embed.png diff --git a/en_us/course_authors/source/Images/google-presentation.png b/en_us/shared/building_and_running_chapters/Images/google-presentation.png similarity index 100% rename from en_us/course_authors/source/Images/google-presentation.png rename to en_us/shared/building_and_running_chapters/Images/google-presentation.png diff --git a/en_us/course_authors/source/Images/google-publish-to-web.png b/en_us/shared/building_and_running_chapters/Images/google-publish-to-web.png similarity index 100% rename from en_us/course_authors/source/Images/google-publish-to-web.png rename to en_us/shared/building_and_running_chapters/Images/google-publish-to-web.png diff --git a/en_us/course_authors/source/Images/google-spreadsheet.png b/en_us/shared/building_and_running_chapters/Images/google-spreadsheet.png similarity index 100% rename from en_us/course_authors/source/Images/google-spreadsheet.png rename to en_us/shared/building_and_running_chapters/Images/google-spreadsheet.png diff --git a/en_us/shared/building_and_running_chapters/building_course/creating_new_course.rst b/en_us/shared/building_and_running_chapters/building_course/creating_new_course.rst index e4e51c913d..4d7ef1cc8c 100644 --- a/en_us/shared/building_and_running_chapters/building_course/creating_new_course.rst +++ b/en_us/shared/building_and_running_chapters/building_course/creating_new_course.rst @@ -42,7 +42,7 @@ Create a New Course part of your course URL, the total number of characters in the following four fields must be 65 or fewer. - .. image:: ../Images/new_course_info.png + .. image:: ../../../shared/building_and_running_chapters/Images/new_course_info.png :alt: Image of the course creation page * For **Course Name**, enter the title of your course. For example, the name @@ -95,7 +95,7 @@ When you return to Studio later, the Studio **My Courses** dashboard page lists the courses that you create along with any courses for which you have course staff privileges. - .. image:: ../Images/open_course.png + .. image:: ../../../shared/building_and_running_chapters/Images/open_course.png :alt: Image of the course on the Studio dashboard To open a course, click the course name. The Studio **Course Outline** page @@ -119,7 +119,7 @@ Categories of tasks in the Course Checklist include: From the **Tools** menu, select **Checklists**. - .. image:: ../Images/checklist.png + .. image:: ../../../shared/building_and_running_chapters/Images/checklist.png :alt: Image of the course checklist diff --git a/en_us/shared/building_and_running_chapters/building_course/provide_overview.rst b/en_us/shared/building_and_running_chapters/building_course/provide_overview.rst new file mode 100644 index 0000000000..cdc197fb9a --- /dev/null +++ b/en_us/shared/building_and_running_chapters/building_course/provide_overview.rst @@ -0,0 +1,465 @@ +.. _Providing a Course Overview: + +##################################### +Providing a Course Overview +##################################### + + +********** +Overview +********** + +Prospective students need to know specific information about your course, +including what the course covers, how much time they should plan to spend on the +course each week, and whether the course requires any prior skills and +knowledge. You specify all of this information in Studio. + +For more information, see the following topics: + +* :ref:`Describe Your Course` +* :ref:`Add a Course Image` +* :ref:`Add a Course Video` +* :ref:`Set Course Time Requirements` +* :ref:`Set Course Prerequisites` +* :ref:`Set Important Dates for Your Course` + +Most of this information appears on the course About page, sometimes called the +course summary page. The following image shows a typical About page. + +.. image:: ../../../shared/building_and_running_chapters/Images/about_page.png + :width: 600 + :alt: An image of the course About page showing the course start and end dates, + prerequisites, description, and other information + +Students see the course About page before they enroll in the course. After a +student enrolls in the course, students can see information about your course on +the Student Dashboard. + +.. image:: ../../../shared/building_and_running_chapters/Images/dashboard.png + :width: 600 + :alt: An image of the dashboard showing courses with start and end dates + +.. note:: If your course will be available on edX.org, you must work with + your edX program manager to prepare the content for your About page, including + the course overview, image, and video. For more information, see the `About + page lesson `_ in `edX101 `_. + + +.. _Describe Your Course: + +********************************* +Describe Your Course +********************************* + +You describe your course in a course overview. The overview contains important +information for students who may be interested in taking your course. It +introduces the main idea of the course and describes the topics or concepts that +the course covers. The overview can also describe the skills and knowledge your +students need to be able to succeed in your course, as well as provide +information about course requirements and staff. + +The course overview is outlined in the following course About page. + +.. image:: ../../../shared/building_and_running_chapters/Images/about-page-course-description.png + :width: 600 + :alt: Image of a course About page with the overview circled + +You use HTML to enter the course overview in Studio. The **Course Overview** +field in Studio contains a boilerplate that includes placeholders. + +To enter the course overview, follow these steps. + +#. From the **Settings** menu, select **Schedule & Details**. +#. Scroll down to the **Introducing Your Course** section, then locate the + **Course Overview** field. + + .. image:: ../../../shared/building_and_running_chapters/Images/course_overview.png + :width: 600 + :alt: Image of the HTML course description. + +3. Replace the placeholders in the boilerplate text to create your course overview. + Studio automatically saves your changes. + + .. note:: Do not edit HTML tags in the boilerplate. These tags align + the content on the course About page. + +4. Below the **Course Overview** field, click **your course summary page** to + see how the description will appear to students. A sample About page opens in + a new window. + + When you make changes, note that you may have to wait a moment for the content to auto-save before the changes appear on the page. + + +.. _Add a Course Image: + +************************ +Add a Course Image +************************ + +You provide a course image that identifies your course. The course image that +you add in Studio appears on the student dashboard. On Edge, the course image +also appears on the course About page. + +.. image:: ../../../shared/building_and_running_chapters/Images/dashboard-course-image.png + :width: 600 + :alt: Image of the course image in the student dashboard + +The course image must be a minimum of 660 pixels in width by 240 pixels in +height, and in .jpg or .png format. + +To add a course image, follow these steps. + +#. From the **Settings** menu, select **Schedule & Details**. +#. Scroll down to the **Course Image** section. +#. To select an image from your computer, click **Upload Course Image**, then + follow the prompts to find and upload your image. +#. View your dashboard to see how the image will appear to students. + +.. _Add a Course Video: + +********************************* +Add a Course Introduction Video +********************************* + +To excite and entice potential students to enroll, each course can have a course +introduction video. The video should reveal some of the personality the +instructors bring to the course. + +.. image:: ../../../shared/building_and_running_chapters/Images/about-page-course-video.png + :alt: Image of the course video in the course About page. + +The video should answer these key questions. + +* Who is teaching the course? +* What university or college is the course affiliated with? +* What topics and concepts does your course cover? +* Why should a learner enroll in your course? + +The video should deliver your message as concisely as possible and have a run +time of less than 2 minutes. + +Ensure your course introduction video follows the same :ref:`Compression +Specifications` and :ref:`Video Formats` guidelines as course content videos. + +To add a course introduction video: + + +#. Upload the course video to YouTube. Make note of the code that appears + between **watch?v =** and **&feature** in the URL. This code appears in the + box below. + + .. image:: ../../../shared/building_and_running_chapters/Images/image127.png + :alt: Image of a sample course video + +2. From the **Settings** menu, select **Schedule & Details**. +#. Scroll down to the **Course Introduction Video** section. +#. In the field below the video box, enter the YouTube video ID (the code you + copied in step 1). When you add the code, the video automatically loads in + the video box. Studio automatically saves your changes. + + +.. _Set Course Time Requirements: + +************************************ +Set Course Time Requirements +************************************ + +To specify the number of hours that you expect students to spend on the course +each week, follow these steps. + +#. From the **Settings** menu, select **Schedule & Details**. +#. Scroll down to the **Requirements** section. +#. In the **Hours of Effort per Week** field, enter the number of hours you + expect students to work on this course each week. +#. View your course About page to see how the requirements will appear to + students. + + +.. _Set Course Prerequisites: + +******************************************** +Set Course Prerequisites +******************************************** + +You might want to make sure that your students have a specific set of skills and +knowledge before they take your course. In addition to suggesting general +requirements in your course overview, you can require students to :ref:`complete +specific prerequisite courses`, or :ref:`take an +entrance exam`, or both. + + +.. _Specify Prerequisite Courses: + +=================================== +Specify Prerequisite Courses +=================================== + +You can require that your students pass a particular edX course before they +enroll in your course. Students see information about course prerequisites on +the course About page. + +.. image:: ../../../shared/building_and_running_chapters/Images/PrereqAboutPage.png + :width: 500 + :alt: A course About page with prerequisite course information circled + +If students have not completed the prerequisite course, they can enroll in your +course and then see your course on the Student Dashboard. However, unlike with +other courses, the Student Dashboard does not provide a link to the courseware. +The Student Dashboard includes a link to the About page for the prerequisite +course. Students can enroll in the prerequisite course from the About page. + +.. image:: ../../../shared/building_and_running_chapters/Images/Prereq_StudentDashboard.png + :width: 500 + :alt: The Student Dashboard with an available course and a course that is + unavailable because it has a prerequisite + +To specify a prerequisite course, you must be a course author in both the +current course and in the prerequisite course. + +#. In Studio, open your course. +#. On the **Settings** menu, select **Schedule & Details**. +#. On the **Schedule & Details** page, scroll to the **Requirements** section. +#. Under **Prerequisite Course**, click the drop-down list to select a course. +#. At the bottom of the page, select **Save Changes**. + +.. note:: Currently, you can specify only one prerequisite course. + + +.. _Require an Entrance Exam: + +=================================== +Require an Entrance Exam +=================================== + +You can require your students to pass an entrance exam before they access your +course materials. If you include an entrance exam, students who enroll in your +course see only the **Course Updates & News** page and an **Entrance Exam** tab +until they pass the exam. + +.. image:: ../../../shared/building_and_running_chapters/Images/EntEx_LandingPage.png + :width: 500 + :alt: The Course Updates & News page with the Entrance Exam tab circled on the + left + + +After students pass the exam, they can access all released materials in your +course. + +To require an entrance exam, follow these steps. + +#. In Studio, open your course. +#. On the **Settings** menu, select **Schedule & Details**. +#. On the **Schedule & Details** page, scroll to the **Requirements** section. +#. Select the **Require students to pass an exam before accessing course + materials** check box. +#. At the bottom of the page, select **Save Changes**. + +After you save your changes, Studio automatically creates an **Entrance Exam** +section in your course outline. To add content to your entrance exam, go to the +course outline. + +Best Practices for Entrance Exams +******************************************** + +We strongly recommend that you follow several guidelines to help you and your +students have a positive experience with entrance exams. + +* Make sure that your beta testers include the entrance exam when they test your + other course content. + +* Make sure that you mention the entrance exam in the course description on your + course About page. Otherwise, students will not know about the entrance exam + before they enroll in your course and try to access course content. + +* Add an anouncement at the top of the **Course Updates & News** page that + contains information and instructions for students who need to take the exam. + When students first try to access content in a course that has an entrance + exam, they see the **Course Updates & News** page. We suggest that you include + the following information. + + * To begin the course entrance exam, students click the **Entrance Exam** tab + on the left side of the screen. + + * After students complete the entrance exam, they have to click the **Entrance + Exam** tab again or refresh the page in their browser. When the page + refreshes, students can see all currently available course content. + + .. image:: ../../../shared/building_and_running_chapters/Images/EntEx_CourseAccordionAfterPass.png + :width: 500 + :alt: The student view after the student has passed the entrance exam, + with all available course sections listed in the course accordion + + +Create an Entrance Exam from the Course Outline +************************************************** + +You create your course entrance exam from the course outline in Studio. Creating +entrance exam content is just like creating other course content. For more +information, see :ref:`Creating Course Content Index`. + +Adjust Scores in the Entrance Exam +******************************************** + +If you find an error in the exam after students have taken it, and corrections +to the exam are unavoidable, you have several options to rescore the exam for +individual students. These options are available on the Instructor Dashboard. + +On the Instructor Dashboard, click **Student Admin**, and then scroll to the +**Entrance Exam Grade Adjustment** section. The following options are available. + +* **Reset Student Attempts**: Reset the value for one particular student's + attempts back to zero so that the student can begin work over again. For more + information, see :ref:`reset_attempts`. + +* **Rescore Student Submission**: Rescore the responses that a student has + submitted. For more information, see :ref:`rescore`. + +* **Delete Student State for Problem**: Delete a student's entire history for + the exam from the database. For more information, see :ref:`delete_state`. + +Another option on the Instructor Dashboard is **Show Background Task History for +Student**. If you reset student attempts, rescore student submissions, or delete +student state, the operation runs in the background. If you want to see a record +of all the operations that have run for the entrance exam, select **Show +Background Task History for Student**. + + + +.. _Set Important Dates for Your Course: + +*********************************** +Set Important Dates for Your Course +*********************************** + +You must set dates and times for enrollment and for the course. + +#. In Studio, from the **Settings** menu, select **Schedule and Details**. +#. Follow the on-screen text to enter the course and enrollment schedule. + + .. image:: ../../../shared/building_and_running_chapters/Images/schedule.png + :width: 450 + :alt: An image of the course schedule page. + + +.. note:: The **Time** fields on this page, and the times that students + see, use Universal Coordinated Time (UTC). + +.. _The Course Start Date: + +======================= +The Course Start Date +======================= + + +.. note:: The default course start date is set far into the future, to + **01/01/2030**. This is to ensure that your course does not start before + you intend it to. You must change the course start date to the date you want + students to begin using the course. + +Students see the course start date and time on their **Current Courses** +dashboards and on the course About page. Students can see some parts of the +course before the course start date. For example, students can see your **Course +Info** page and course-wide discussion topics as soon as they enroll in your +course. For more information about course-wide discussion topics, see +:ref:`Create CourseWide Discussion Topics`. + +The following example shows the course start date and time on the course About +page: + +.. image:: ../../../shared/building_and_running_chapters/Images/about-page-course-start.png + :width: 600 + :alt: An image of the course About page, with the start date circled. + +In the dashboard, students see the start dates and times for each of their +courses, as in the following examples. + +.. image:: ../../../shared/building_and_running_chapters/Images/dashboard-course-to-start.png + :width: 600 + :alt: An image of two courses in the student dashboard, with the start dates + and times circled. + +.. note:: If you do not specify a start time for your course, students see + the default start time, 00:00 Coordinated Universal Time (UTC). + + +.. _Set the Advertised Start Date: + +====================================== +Set the Advertised Start Date +====================================== + +You can set an advertised start date for your course that is different than the +course start date you set in the **Schedule and Details** page. You may want to +do this if there is uncertainty about the exact start date. For example, you +could advertise the start date as **Spring, 2014**. + +To set an advertised start date: + +#. From the **Settings** menu, select **Advanced Settings**. +#. Find the **Course Advertised Start Date** policy key. The default value is + **null**. +#. Enter the value you want to display as the advertised start date. You can + use any string, enclosed in double quotation marks. If you format the string + as a date (for example, as 02/01/2014), the value is parsed and presented to + students as a date. + + .. image:: ../../../shared/building_and_running_chapters/Images/advertised_start.png + :alt: Image of the advertised start date policy key with a value of "anytime, + self-paced" + +4. Click **Save Changes** at the bottom of the page. + +The start date shown on the dashboard is now the value of the **Course +Advertised Start Date** policy key: + +.. image:: ../../../shared/building_and_running_chapters/Images/dashboard-course_adver_start.png + :width: 600 + :alt: An image of a course listing in the student dashboard, with the + advertised start date circled. + +If you do not change the default course start date (01/01/2030), and the +**Course Advertised Start Date** policy value is ``null``, then the student +dashboard does not list a start date for the course. Students just see that +the course has not yet started. + +.. _The Course End Date: + +===================== +The Course End Date +===================== + +The course end date is the date after which students can no longer earn credit +toward certificates. Students who have earned certificates can view them after +the course end date. + +.. important:: + If you do not set a course end date, students will not be able to access + earned certificates. + +After grades and certificates are finalized, students see the course end date +on their personal **Current Courses** dashboards, as shown in the following +examples. + +* If grades and certificates are not yet finalized, students can see the course + end date and a message: + + .. image:: ../../../shared/building_and_running_chapters/Images/dashboard-wrapping-course.png + :alt: Image of a course on the student dashboard that has ended, but not + been graded + +* When grades and certificates are finalized, students who have not earned a + certificate see their score and the score required to earn a certificate: + + .. image:: ../../../shared/building_and_running_chapters/Images/dashboard-no-cert-course.png + :alt: Image of a course on the student dashboard that has ended, but not + been graded + +* Students whose final score is equal to or higher than the required score can + click **Download Certificate** to get their certificates as PDFs: + + .. image:: ../../../shared/building_and_running_chapters/Images/dashboard-completed-course.png + :alt: Image of a course on the student dashboard that has ended, but not + been graded + diff --git a/en_us/shared/building_and_running_chapters/creating_content/libraries.rst b/en_us/shared/building_and_running_chapters/creating_content/libraries.rst new file mode 100644 index 0000000000..c146252335 --- /dev/null +++ b/en_us/shared/building_and_running_chapters/creating_content/libraries.rst @@ -0,0 +1,389 @@ +.. _Content Libraries: + +############################## +Working with Content Libraries +############################## + + +.. _ Content Libraries Overview: + +************************** +Content Libraries Overview +************************** + +In Studio, if you have course creation privileges, you can create a content +library to build a pool of components that can be used in randomized assignments +in your courses. You can add HTML components, problems, and video components to +a library. Peer assessment and discussion components are not supported in +content libraries. + +.. note:: Content libraries are available only for courses that have course + identifiers in this format: ``{key type}:{org}+{course}+{run}``. For example, ``course-v1:edX+DemoX+Demo_2015``. Your course identifier appears in the browser address bar as the final part of the URL when you open your course in Studio. For more details, see :ref:`Create a New Course`. + +After creating a library and adding components to it, if you have :ref:`enabled +content libraries` in your course, you can use these +library components in randomized assignments in your course. You do this by +adding a randomized content block to a course unit and indicating one or more +libraries from which the randomized content is to drawn, as well as the number +and type of problems that each student is assigned. If you specify more than one +library from which to randomly draw components for the randomized assignment, +the content from all specified libraries is combined before the random selection +is made. + +Libraries have separate users and levels of access from courses. Initially, only +the person who created the library has access. She can add other users to the +library. For details, see :ref:`Give Other Users Access to Your Library`. The +libraries that you create or have access to are listed on the **Libraries** tab +on the Studio Home page. + +See the following sections for details about creating and managing content +libraries. + +* :ref:`Enable Content Libraries` +* :ref:`Create a New Library` +* :ref:`Add Components to a Library` +* :ref:`View the Contents of a Library` +* :ref:`Edit Components in a Library` +* :ref:`Give Other Users Access to Your Library` + +See the following sections for details about using content library components in +a course. + +* :ref:`Use Components from Libraries in a Course` +* :ref:`Add a Randomized Content Block to Your Course` +* :ref:`View the Matching Components in a Randomized Content Block` +* :ref:`Edit Components in Randomized Content Blocks` +* :ref:`Get the Latest Version of Library Content` + + +.. _Create a New Library: + +******************** +Create a New Library +******************** + +Use :ref:`content libraries` to build a pool of components +that can be used in randomized assignments in your courses. You can create +content libraries if you have course creation privileges. + +For information about adding other users to a library after you create it, see +:ref:`Give Other Users Access to Your Library`. + +To create a new content library, follow these steps. + +#. Log in to Studio. + +#. Click **New Library**. +#. Enter the required information for your new library, then click **Create**. + + .. note:: Enter new library information carefully. The values in these + fields become part of the URL for your library, therefore the total number + of characters in the **Library Name**, **Organization**, and **Library + Code** fields must be 65 or fewer. + + .. image:: ../../../shared/building_and_running_chapters/Images/ContentLibrary_NewCL.png + :alt: Image of the library creation page + + + * For **Library Name**, enter the public display name for your library. Choose + a meaningful name that will help you and other course team members to + identify the contents of the library. For example, "Level 200 Math + Problems". + + * For **Organization**, enter the identifier for your university. For + example, enter HarvardX or MITx. Do not include spaces or special + characters. + + * For **Library Code**, enter an identifier for your library that is unique + within your organization. This code becomes part of the URL for your + library, so do not include spaces or special characters in the code. + + +4. Click **Create**. + +You see the new library, to which you can now add components. For details about +adding components to a library, see :ref:`Add Components to a Library`. + +The system-generated Library ID for the new library appears in the sidebar. + + .. image:: ../../../shared/building_and_running_chapters/Images/ContentLibraryID.png + :alt: The Library ID for the new library is shown the sidebar + +.. note:: Copy or make a note of the Library ID for the new library. When you + add a randomized content block to a course unit, you use the Library ID to + specify this library as a source for the randomized content. + + +.. _Edit a Library: + +************** +Edit a Library +************** + +After you create a library, the only change you can make to the initial library +information is to the name. However, at any time, you can make changes to the +components in your library, including adding or deleting components or editing +the settings of components. For details about editing the contents of a library, +see :ref:`Edit Components in a Library` and :ref:`Add Components to a Library`. + + +To change the name of a library, follow these steps. + +#. Log in to Studio. +#. Click **Libraries**, then click the library whose name you want to edit. + +#. Click the **Edit** icon next to the library name. + + The library name field becomes editable. + + .. image:: ../../../shared/building_and_running_chapters/Images/ContentLibrary_EditName.png + :alt: The Edit icon to the right of the Library Name + +4. In the library name field, make edits or enter a new library name. +#. Click anywhere outside the library name field to save your changes. + + +For details about giving other users access to the library, see :ref:`Give Other +Users Access to Your Library`. + + +.. _Add Components to a Library: + +**************************** +Add Components to a Library +**************************** + +To add new :ref:`components` to your library, follow these +steps. + +#. Log in to Studio. +#. Click **Libraries**, then click the library that you want to add components to. + +#. Click **Add Component**, then click the component type that you want to add + under **Add New Component**. + +For more information about the types of components you can add to a library, see +these topics. + +* :ref:`Working with HTML Components` +* :ref:`Working with Problem Components` +* :ref:`Working with Video Components` + +After you add a component to a library, you can edit its settings. These +settings are retained when the component is selected from the library and used +in a course. + +When a component from the library is used in a randomized content block, you can +further edit the component as it exists in the unit, without affecting the +original version in the library. For details, refer to :ref:`Edit Components in +a Library` and :ref:`Get the Latest Version of Library Content`. + + +.. _View the Contents of a Library: + +****************************** +View the Contents of a Library +****************************** + +To view the entire contents of a library in Studio, follow these steps. + +#. Log in to Studio. +#. Click **Libraries**, then click the library whose components you want to + view. + +The components in the library display in the order in which they were added, +with the most recently added at the bottom. If your library has more than 10 +components, additional components are shown on other pages. + +The range of the components shown on the current page, and the total number of +components, are shown at the top of the page. + +You can navigate through the pages in these ways: + +* Use the **<** and **>** buttons at the top and bottom of the list to navigate + to the previous and next pages. + +* At the bottom of the page, you can edit the first number in the page range. + Click the number to place your cursor in the field, then enter the page number + you want to jump to. + + .. image:: ../../../shared/building_and_running_chapters/Images/file_pagination.png + :alt: Image showing a pair of page numbers with the first number circled + +To view the list of matching components in the library, see :ref:`View the Matching Components in a Randomized Content Block`. + +To view the randomized content as a student would see it, see :ref:`View the +Randomized Content as a Student`. + + +.. _Edit Components in a Library: + +**************************** +Edit Components in a Library +**************************** + +After you have added components to a content library, you can edit, duplicate, +or delete them. + +For step-by-step instructions for editing, duplicating, or +deleting components, refer to the following topics: + +* :ref:`Edit a Component` +* :ref:`Duplicate a Component` +* :ref:`Delete a Component` + +.. note:: If you modify components in your library that are in use in a course, + these updates in the "source" library are not reflected in the course unless + you manually update the randomized content block in the course unit. For + details about updating library components used in your course to match the + latest version in the content library, see :ref:`Get the Latest Version of + Library Content`. + + +.. _Delete a Library: + +***************** +Delete a Library +***************** + +You cannot delete a library. Instead, you can discontinue use of an unwanted +library. To do so, first make sure that none of its components are in use in any +courses, then delete all components in the library. You can also :ref:`edit the +name of the library` to make it clear to other course staff that +the library should not be used as a source of randomized assignment content in +courses. + +For details about deleting components in a library, see :ref:`Edit Components in +a Library`. + + +.. _Give Other Users Access to Your Library: + +*************************************** +Give Other Users Access to Your Library +*************************************** + +When you create a library, you are automatically assigned an Admin role in that +library. + +You can give other Studio users access to your library. Depending on the level +of access that you give them in the library, additional library users can view +and use library content in courses, edit library content, or add and manage +other library users. All users to whom you give library access must be +registered with Studio and have an active account. + +These are the levels of access for libraries: + +* **User** -- Users can view library content and can use library components in + their courses, but they cannot edit the contents of a library. + +* **Staff** -- Staff can use library components in their courses. In addition, + as content co-authors, they have full editing privileges in a library. + +* **Admin** -- Admins have full editing privileges for a library. In addition, + they can add and remove other team members from library access. There must be at + least one user with Admin privileges in a library. + +.. note:: The levels of access for libraries are hierarchical. You can add new + library members only with the **User** level of access, after which you can + give them the **Staff** level of access. You can give the **Admin** level of + access only to people who already have the **Staff** level of access. + + +========================= +Add a User to the Library +========================= + +To grant a user initial **User** access to a library, follow these steps. + +.. note:: Only library users with the **Admin** level of access can add users to + the library. + +#. Ensure that the new library member has an active Studio account. +#. On the Studio home page, click the **Libraries** tab and locate the library + to which you are adding this user. +#. From the **Settings** menu select **User Access**. +#. On the **User Access** page, click **Add a New User**. +#. Enter the new user's email address, then click **ADD USER**. + + The new user is added to the list of library members with the **User** level + of access. + + +============================== +Remove a User from the Library +============================== + +You can remove users from the library at any time, regardless of the level of +access that they have. + +To remove a user from the library, follow these steps. + +#. In Studio, click the **Libraries** tab and locate your library. +#. From the **Settings** menu select **User Access**. + +#. On the **User Access** page, locate the user that you want to remove. +#. Hover over the user's box and click the trash can icon. + + You are prompted to confirm the deletion. + +5. Click **Delete**. + + The user is removed from the library. + + +========================= +Add Staff or Admin Access +========================= + +The levels of access for libraries are hierarchical. You can add new library +members only with the **User** level of access, after which you can give them +the **Staff** level of access. You can give the **Admin** level of access only +to people who already have the **Staff** level of access. + +To give a library member a higher level of access to the library, follow these +steps. + + +#. In Studio, click the **Libraries** tab and locate your library. +#. From the **Settings** menu select **User Access**. + +#. On the **User Access** page, locate the user to whom you are giving + additional privileges. + + - If he currently has **User** access, click **Add Staff Access**. + - If he currently has **Staff** access, click **Add Admin Access**. + + The user's display listing is updated to indicate the new level of access. In + addition, their listing now includes a button to remove their current level of + access and move them back to their previous level of access. For details about + reducing a user's level of access to a library, see :ref:`Remove Staff or + Admin Access`. + + +.. _Remove Staff or Admin Access: + +============================ +Remove Staff or Admin Access +============================ + +After you have granted users **Staff** or **Admin** access, you (or other +**Admin** library users) can reduce their levels of access. + +To remove **Staff** or **Admin** access from a library user, follow these steps. + +#. In Studio, click the **Libraries** tab and locate your library. +#. From the **Settings** menu select **User Access**. + +#. On the **User Access** page, locate the user whose access level you are + changing. + + - If she currently has **Staff** access, click **Remove Staff Access**. + - If she currently has **Admin** access, click **Remove Admin Access**. + + The user's display listing is updated to indicate their new role. + +.. note:: There must always be at least one Admin for a library. If there is + only one user with the Admin role, you cannot remove him or her from the + Admin role unless you first assign another user to the Admin role. + diff --git a/en_us/shared/building_and_running_chapters/developing_course/course_components.rst b/en_us/shared/building_and_running_chapters/developing_course/course_components.rst index b20547732c..89b9936438 100644 --- a/en_us/shared/building_and_running_chapters/developing_course/course_components.rst +++ b/en_us/shared/building_and_running_chapters/developing_course/course_components.rst @@ -30,7 +30,7 @@ unit can contain one or more components. A student can view the name of all components in a unit by hovering over the unit in the ribbon at the top of the page. -.. image:: ../Images/ComponentNames_CourseRibbon.png +.. image:: ../../../shared/building_and_running_chapters/Images/ComponentNames_CourseRibbon.png :alt: Image of the component list for a unit By default, Studio includes four types of components. @@ -55,7 +55,7 @@ Add a Component To add a component to the unit, click the component type that you want under **Add New Component**. -.. image:: ../Images/AddNewComponent.png +.. image:: ../../../shared/building_and_running_chapters/Images/AddNewComponent.png :alt: Image of adding a new component For more information, see the documentation for the specific component type @@ -77,7 +77,7 @@ Edit a Component To edit a component, click **Edit**: -.. image:: ../Images/unit-edit.png +.. image:: ../../../shared/building_and_running_chapters/Images/unit-edit.png :alt: Image of a unit with Edit icon circled Then follow instructions for the type of component you are editing. @@ -99,7 +99,7 @@ To set the display name for a component: #. Click **Settings**. #. Edit the **Display Name** field. - .. image:: ../Images/display-name.png + .. image:: ../../../shared/building_and_running_chapters/Images/display-name.png :alt: Image of the Display Name field for a component. 4. Click **Save**. @@ -120,7 +120,7 @@ content. To duplicate a component, click the Duplicate icon in the component header: -.. image:: ../Images/unit-dup.png +.. image:: ../../../shared/building_and_running_chapters/Images/unit-dup.png :alt: Image of a unit with Duplicate icon circled Then follow instructions for the type of component you are editing. @@ -143,7 +143,7 @@ To delete a component: #. Click the Delete icon in the component header: -.. image:: ../Images/unit-delete.png +.. image:: ../../../shared/building_and_running_chapters/Images/unit-delete.png :alt: Image of a unit with Delete icon circled 2. When you receive the confirmation prompt, click **Yes, delete this @@ -168,7 +168,7 @@ the contained components are referred to as *children*. In the unit page, a parent component appears with the display name and a **View** link. For example: -.. image:: ../Images/component_container.png +.. image:: ../../../shared/building_and_running_chapters/Images/component_container.png :alt: Image of a unit page with a parent component @@ -195,13 +195,13 @@ When you click **View** in the parent component, the parent component page opens, showing all child components. In this example, Child Component A contains an HTML component and a video: -.. image:: ../Images/child-components-a.png +.. image:: ../../../shared/building_and_running_chapters/Images/child-components-a.png :alt: Image of an expanded child component Click the arrow next to a child component name to collapse it and hide the component's contents: -.. image:: ../Images/child-components.png +.. image:: ../../../shared/building_and_running_chapters/Images/child-components.png :alt: Image of a child component page Click the arrow again to expand the component. @@ -224,7 +224,7 @@ To add a child component, open and expand the parent component. Then click the component type that you want under **Add New Component** within the parent component. -.. image:: ../Images/AddNewComponent.png +.. image:: ../../../shared/building_and_running_chapters/Images/AddNewComponent.png :alt: Image of adding a new component For more information, see the documentation for the specific component type @@ -297,7 +297,7 @@ The Student View of Nested Components For students, all parent and child components are displayed on the unit page. The following example shows the student view of the unit described above: -.. image:: ../Images/nested_components_student_view.png +.. image:: ../../../shared/building_and_running_chapters/Images/nested_components_student_view.png :alt: Image of the student's view of nested components .. note:: @@ -322,7 +322,7 @@ drag it into Child Component B. Select the video component, and as you drag it into Child Component B, release the mouse button when a dashed outline of the component you are moving appears in the new location: -.. image:: ../Images/drag_child_component.png +.. image:: ../../../shared/building_and_running_chapters/Images/drag_child_component.png :alt: Image of dragging a child component to a new location You can also drag a child component outside of a parent, so that the child diff --git a/en_us/shared/building_and_running_chapters/developing_course/course_outline.rst b/en_us/shared/building_and_running_chapters/developing_course/course_outline.rst index b0232562fe..22b231b636 100644 --- a/en_us/shared/building_and_running_chapters/developing_course/course_outline.rst +++ b/en_us/shared/building_and_running_chapters/developing_course/course_outline.rst @@ -42,7 +42,7 @@ select **Outline**. The first time you view an outline for a course, it contains no content. -.. image:: ../Images/outline_empty.png +.. image:: ../../../shared/building_and_running_chapters/Images/outline_empty.png :alt: An empty course outline You must :ref:`create the first section`. @@ -55,7 +55,7 @@ The following example shows a sample course in the outline, with indications for sections, subsections, and units. As you develop your course, it will begin to look like this example: -.. image:: ../Images/outline-callouts.png +.. image:: ../../../shared/building_and_running_chapters/Images/outline-callouts.png :alt: An outline with callouts for sections, subsections, and units As this example shows, the course is organized into the following levels: @@ -78,7 +78,7 @@ The content you see in the outline in Studio is displayed to students in the Courseware tab in the LMS. The following image shows how a student sees your course content: -.. image:: ../Images/Course_Outline_LMS.png +.. image:: ../../../shared/building_and_running_chapters/Images/Course_Outline_LMS.png :alt: Image of course conent from student's point of view .. _Navigating the Course Outline: @@ -91,12 +91,12 @@ In Studio, you navigate the course outline by expanding and collapsing sections and subsections. Use the drop-down icon next to a section or subsection name to expand or collapse its contents: -.. image:: ../Images/outline-expand-collapse.png +.. image:: ../../../shared/building_and_running_chapters/Images/outline-expand-collapse.png :alt: The outline with expand and collapse icons circled When you expand a subsection, all units in the subsection are visible: -.. image:: ../Images/outline-with-units.png +.. image:: ../../../shared/building_and_running_chapters/Images/outline-with-units.png :alt: The outline with an expanded subsection Click the name of a unit to open the :ref:`unit page`. @@ -112,19 +112,19 @@ You add sections, subsections, and units directly in the outline. To add a section to the end of the outline, click **New Section** at the top of the outline page or at the bottom of the outline: -.. image:: ../Images/outline-create-section.png +.. image:: ../../../shared/building_and_running_chapters/Images/outline-create-section.png :alt: The outline with the New Section buttons circled To add a subsection to the end of the section, expand the section and click **New Subsection**: -.. image:: ../Images/outline-new-subsection.png +.. image:: ../../../shared/building_and_running_chapters/Images/outline-new-subsection.png :alt: The outline with the New Subsection button circled To add a unit to the end of a subsection, expand the subsection and click **New Unit**: -.. image:: ../Images/outline-new-unit.png +.. image:: ../../../shared/building_and_running_chapters/Images/outline-new-unit.png :alt: The outline with the New Subsection button circled The :ref:`unit` page opens. @@ -154,7 +154,7 @@ To modify settings for a section, subsection, or unit, click the settings icon for that object. In the following example, the settings icon is circled for a section, a subsection, and two units: -.. image:: ../Images/settings-icons.png +.. image:: ../../../shared/building_and_running_chapters/Images/settings-icons.png :alt: Settings icons in the course outline For more information, see the links above. @@ -173,7 +173,7 @@ To publish new and changed units, click the publish icon for a section, subsection, or unit. In the following example, the publish icon is circled for a section, subsection, and unit: -.. image:: ../Images/outline-publish-icons.png +.. image:: ../../../shared/building_and_running_chapters/Images/outline-publish-icons.png :alt: Publishing icons in the course outline .. note:: @@ -201,7 +201,7 @@ the object's box until the cursor changes to a four-headed arrow. For example, in the image below, the handle for the subsection Lesson 1 - Getting Started is selected: -.. image:: ../Images/outline-drag-select.png +.. image:: ../../../shared/building_and_running_chapters/Images/outline-drag-select.png :alt: A subsection handle selected to drag it Then, click and drag the object to the location that you want. @@ -212,7 +212,7 @@ release the mouse button. For example, in the image below, the subsection Lesson 1 - Getting Started is being moved to the end of the section Introduction: -.. image:: ../Images/outline-drag-new-location.png +.. image:: ../../../shared/building_and_running_chapters/Images/outline-drag-new-location.png :alt: A subsection being dragged to a new section If you did not expand the section or subsection you are moving the object to, @@ -221,7 +221,7 @@ object to a valid location. You can then release the mouse button. For example, in the image below, the subsection Lesson 1 - Getting Started is being moved to the collapsed section Introduction: -.. image:: ../Images/outline-drag-new-location-collapsed.png +.. image:: ../../../shared/building_and_running_chapters/Images/outline-drag-new-location-collapsed.png :alt: A subsection being dragged to a new section .. _Delete Content in the Course Outline: @@ -239,7 +239,7 @@ You delete sections, subsections, and units from the course outline. Click the delete icon in the box for the object you want to delete: -.. image:: ../Images/outline-delete.png +.. image:: ../../../shared/building_and_running_chapters/Images/outline-delete.png :alt: The outline with Delete icons circled You are prompted to confirm the deletion. diff --git a/en_us/shared/building_and_running_chapters/developing_course/workflow.rst b/en_us/shared/building_and_running_chapters/developing_course/workflow.rst index 54fd753502..a983914789 100644 --- a/en_us/shared/building_and_running_chapters/developing_course/workflow.rst +++ b/en_us/shared/building_and_running_chapters/developing_course/workflow.rst @@ -61,7 +61,7 @@ Visibility>` by setting release dates on the outline and publishing units. The following diagram summarizes the content creation workflow: -.. image:: ../Images/workflow-create-content.png +.. image:: ../../../shared/building_and_running_chapters/Images/workflow-create-content.png :alt: Diagram of the content creation process It is recommended that you :ref:`test course content **Grading**. For more information, see :ref:`Configure the Assignment Types`. - .. image:: ../Images/Grading_Configuration_Studio.png + .. image:: ../../../shared/building_and_running_chapters/Images/Grading_Configuration_Studio.png :alt: Studio example of homework assignment type and grading weight .. important:: Any changes that you make to the course grading policy, to @@ -148,7 +148,7 @@ every currently enrolled student. You can open ``{course_id}_grade_report_{date}.csv`` files in a spreadsheet application to sort, graph, and compare data. -.. image:: ../Images/Grade_Report.png +.. image:: ../../../shared/building_and_running_chapters/Images/Grade_Report.png :alt: A course grade report, opened in Excel, showing the grades acheived by students on several homework assignments and the midterm @@ -203,7 +203,7 @@ on the Instructor Dashboard. #. Click **View Gradebook**. Grades are calculated and the gradebook displays. - .. image:: ../Images/Student_Gradebook.png + .. image:: ../../../shared/building_and_running_chapters/Images/Student_Gradebook.png :alt: Course gradebook with rows for students and columns for assignment types @@ -280,14 +280,14 @@ To view the **Progress** page for a student: course, and the total grade earned for the course to date. The chart does not reflect any cohort or experiment group assignments. - .. image:: ../Images/Student_Progress.png + .. image:: ../../../shared/building_and_running_chapters/Images/Student_Progress.png :alt: Progress page chart for a student: includes a column graph with the score acheived for each assignment To learn more about a particular assignment, move the cursor onto the value in the chart. A brief description displays. - .. image:: ../Images/Student_Progress_mouseover.png + .. image:: ../../../shared/building_and_running_chapters/Images/Student_Progress_mouseover.png :alt: Progress page with a tooltip for the X that was graphed for the last homework assignment, which indicates that the lowest homework score is dropped @@ -296,7 +296,7 @@ To view the **Progress** page for a student: contain assignments are listed on the right. The student's individual problem scores display. - .. image:: ../Images/Student_Progress_list.png + .. image:: ../../../shared/building_and_running_chapters/Images/Student_Progress_list.png :alt: Bottom portion of a Progress page for the same student with the score acheived for each problem in the first course subsection @@ -312,7 +312,7 @@ on the **Progress** page. In this example grade report, the indicated student has a current grade of 0.43 (43%). -.. image:: ../Images/Grade_Report_example.png +.. image:: ../../../shared/building_and_running_chapters/Images/Grade_Report_example.png :alt: A course grade report with a single student's information indicated by a rectangle @@ -330,7 +330,7 @@ In this example grade report, the indicated student has a current grade of 0.43 On the student's **Progress** page, you see the same information graphically represented; however, the student's "total" of 43% is on the far right. -.. image:: ../Images/Student_Progress.png +.. image:: ../../../shared/building_and_running_chapters/Images/Student_Progress.png :alt: Progress page for a student also included on the grade report: includes a column graph with the grade acheived for each assignment @@ -357,7 +357,7 @@ visualized as a chart with entries for all the assignments, total percentage earned in the course so far, and percent needed for each grade cutoff. Here is an example of a student's progress through edX101. -.. image:: ../Images/StudentView_GradeCutoffs.png +.. image:: ../../../shared/building_and_running_chapters/Images/StudentView_GradeCutoffs.png :alt: Image of a student's Course Progress page with the grade cutoffs legend highlighted @@ -373,7 +373,7 @@ Further down on the **Progress** page is a list of all the subsections in the course, with the scores recorded for the student for all problems in the course. Here is the **Progress** page for the student in the example above: -.. image:: ../Images/StudentView_Problems.png +.. image:: ../../../shared/building_and_running_chapters/Images/StudentView_Problems.png :width: 800 :alt: Image of a student's Course Progress page with problems highlighted @@ -432,7 +432,7 @@ To find the unique location identifier for a problem: Information about the problem displays, including its **location**. - .. image:: ../Images/Problem_URL.png + .. image:: ../../../shared/building_and_running_chapters/Images/Problem_URL.png :alt: The Staff Debug view of a problem with the location identifier indicated diff --git a/en_us/shared/exercises_tools/google_calendar.rst b/en_us/shared/exercises_tools/google_calendar.rst index 30b2fc7c94..6b79b1ced2 100644 --- a/en_us/shared/exercises_tools/google_calendar.rst +++ b/en_us/shared/exercises_tools/google_calendar.rst @@ -36,7 +36,7 @@ You can embed a Google calendar in your course so that students see the calendar in the courseware. You can use a Google calendar to share quiz dates, office hours, or other schedules of interest to students. For example: -.. image:: ../Images/google-calendar.png +.. image:: ../../../shared/building_and_running_chapters/Images/google-calendar.png :alt: A Google calendar in courseware ******************************************* @@ -78,7 +78,7 @@ To enable Google Calendars in your course: add a comma after the closing quotation mark for the last value, and then type ``"google-calendar"``. For example: - .. image:: ../Images/google-advanced-setting.png + .. image:: ../../../shared/building_and_running_chapters/Images/google-advanced-setting.png :alt: Advanced modules setting for Google Calendars #. At the bottom of the page, select **Save Changes**. @@ -135,7 +135,7 @@ Make the Google Calendar Public #. Click the **Share this Calendar** tab, and then select **Make this calendar public**. - .. image:: ../Images/google-calendar-settings.png + .. image:: ../../../shared/building_and_running_chapters/Images/google-calendar-settings.png :alt: Google calendar settings 7. Select **Save**. @@ -155,7 +155,7 @@ Obtain the Google Calendar ID colored **XML**, **ICAL**, and **HTML** buttons. In parentheses, you can see the calendar ID. - .. image:: ../Images/google-calendar-address.png + .. image:: ../../../shared/building_and_running_chapters/Images/google-calendar-address.png :width: 600 :alt: Image of Calendar Address label with the calendar ID to the right @@ -194,13 +194,13 @@ To add a Google calendar component: The new component is added to the unit, with the default edX Google calendar embedded. - .. image:: ../Images/google-calendar-studio.png + .. image:: ../../../shared/building_and_running_chapters/Images/google-calendar-studio.png :width: 600 :alt: The Google calendar component in a unit page #. In the new component, select **Edit**. - .. image:: ../Images/google-calendar-edit.png + .. image:: ../../../shared/building_and_running_chapters/Images/google-calendar-edit.png :width: 600 :alt: The Google calendar editor diff --git a/en_us/shared/exercises_tools/google_docs.rst b/en_us/shared/exercises_tools/google_docs.rst index 85d25208a5..f606d994cd 100644 --- a/en_us/shared/exercises_tools/google_docs.rst +++ b/en_us/shared/exercises_tools/google_docs.rst @@ -34,7 +34,7 @@ Overview You can embed a Google Drive file in your course so that students see the file in the courseware. For example, you can share a Google spreadsheet with students. -.. image:: ../Images/google-spreadsheet.png +.. image:: ../../../shared/building_and_running_chapters/Images/google-spreadsheet.png :width: 600 :alt: A Google spreadsheet in courseware @@ -85,7 +85,7 @@ To enable Google Drive files in your course: add a comma after the closing quotation mark for the last value, and then type ``"google-document"``. For example: - .. image:: ../Images/google-advanced-setting.png + .. image:: ../../../shared/building_and_running_chapters/Images/google-advanced-setting.png :alt: Advanced modules setting for Google documents #. At the bottom of the page, select **Save Changes**. @@ -131,13 +131,13 @@ file to the web and obain the embed code for the file. #. Open the Google Drive file. #. From the **File** menu, select **Publish to the web**. - .. image:: ../Images/google-publish-to-web.png + .. image:: ../../../shared/building_and_running_chapters/Images/google-publish-to-web.png :alt: The Google Drive file Publish to the web dialog box #. Click **Publish**, then select **OK** to confirm the action. #. Click the **Embed** tab. - .. image:: ../Images/google-embed.png + .. image:: ../../../shared/building_and_running_chapters/Images/google-embed.png :alt: The Google Drive file Publish to web Embed tab #. Copy the complete string in the **Embed** field, including the ``