Skip to content

Commit

Permalink
Move developing course folder, etc.
Browse files Browse the repository at this point in the history
  • Loading branch information
catong committed Nov 20, 2015
1 parent 2dccacb commit 1e33b6f
Show file tree
Hide file tree
Showing 26 changed files with 180 additions and 180 deletions.
Original file line number Diff line number Diff line change
@@ -1 +1 @@
.. include:: ../../../shared/building_and_running_chapters/developing_course/controlling_content_visibility.rst
.. include:: ../../../shared/developing_course/controlling_content_visibility.rst
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
.. include:: ../../../shared/building_and_running_chapters/developing_course/course_components.rst
.. include:: ../../../shared/developing_course/course_components.rst

Original file line number Diff line number Diff line change
@@ -1 +1 @@
.. include:: ../../../shared/building_and_running_chapters/developing_course/course_outline.rst
.. include:: ../../../shared/developing_course/course_outline.rst
Original file line number Diff line number Diff line change
@@ -1 +1 @@
.. include:: ../../../shared/building_and_running_chapters/developing_course/course_sections.rst
.. include:: ../../../shared/developing_course/course_sections.rst
Original file line number Diff line number Diff line change
@@ -1 +1 @@
.. include:: ../../../shared/building_and_running_chapters/developing_course/course_subsections.rst
.. include:: ../../../shared/developing_course/course_subsections.rst
Original file line number Diff line number Diff line change
@@ -1 +1 @@
.. include:: ../../../shared/building_and_running_chapters/developing_course/course_units.rst
.. include:: ../../../shared/developing_course/course_units.rst
2 changes: 1 addition & 1 deletion en_us/course_authors/source/developing_course/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
Developing Your Course
##########################

Use the chapters in this section to understand how to develop your course
Use the topics in this section to understand how to develop your course
content in the Studio Outline page.

For information on building specific course component types, see :ref:`Creating
Expand Down
Original file line number Diff line number Diff line change
@@ -1 +1 @@
.. include:: ../../../shared/building_and_running_chapters/developing_course/testing_courseware.rst
.. include:: ../../../shared/developing_course/testing_courseware.rst
2 changes: 1 addition & 1 deletion en_us/course_authors/source/developing_course/workflow.rst
Original file line number Diff line number Diff line change
@@ -1 +1 @@
.. include:: ../../../shared/building_and_running_chapters/developing_course/workflow.rst
.. include:: ../../../shared/developing_course/workflow.rst
Original file line number Diff line number Diff line change
@@ -1 +1 @@
.. include:: ../../../shared/building_and_running_chapters/developing_course/controlling_content_visibility.rst
.. include:: ../../../shared/developing_course/controlling_content_visibility.rst
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
.. include:: ../../../shared/building_and_running_chapters/developing_course/course_components.rst
.. include:: ../../../shared/developing_course/course_components.rst

Original file line number Diff line number Diff line change
@@ -1 +1 @@
.. include:: ../../../shared/building_and_running_chapters/developing_course/course_outline.rst
.. include:: ../../../shared/developing_course/course_outline.rst
Original file line number Diff line number Diff line change
@@ -1 +1 @@
.. include:: ../../../shared/building_and_running_chapters/developing_course/course_sections.rst
.. include:: ../../../shared/developing_course/course_sections.rst
Original file line number Diff line number Diff line change
@@ -1 +1 @@
.. include:: ../../../shared/building_and_running_chapters/developing_course/course_subsections.rst
.. include:: ../../../shared/developing_course/course_subsections.rst
Original file line number Diff line number Diff line change
@@ -1 +1 @@
.. include:: ../../../shared/building_and_running_chapters/developing_course/course_units.rst
.. include:: ../../../shared/developing_course/course_units.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
Developing Your Course
##########################

Use the chapters in this section to understand how to develop your course
Use the topics in this section to understand how to develop your course
content in the Studio Outline page.

For information on building specific course component types, see :ref:`Creating
Expand Down
Original file line number Diff line number Diff line change
@@ -1 +1 @@
.. include:: ../../../shared/building_and_running_chapters/developing_course/testing_courseware.rst
.. include:: ../../../shared/developing_course/testing_courseware.rst
Original file line number Diff line number Diff line change
@@ -1 +1 @@
.. include:: ../../../shared/building_and_running_chapters/developing_course/workflow.rst
.. include:: ../../../shared/developing_course/workflow.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@
Developing Course Components
###################################

This section describes how you develop course components.
This section describes how you develop course components.

.. contents::
.. contents::
:local:
:depth: 1

Expand All @@ -27,7 +27,7 @@ unit can contain one or more components.
A learner can view the names of all components in a unit by moving the cursor
over each unit in the learning sequence at the top of the page.

.. image:: ../../../shared/building_and_running_chapters/Images/ComponentNames_CourseRibbon.png
.. image:: ../../../shared/Images/ComponentNames_CourseRibbon.png
:alt: Image of the component list for a unit.

By default, Studio includes four types of components for you to add to your
Expand All @@ -53,7 +53,7 @@ Add a Component
To add a component to the unit, select the component type that you want under
**Add New Component**.

.. image:: ../../../shared/building_and_running_chapters/Images/AddNewComponent.png
.. image:: ../../../shared/Images/AddNewComponent.png
:alt: Image of adding a new component

For more information, see the documentation for the specific component type
Expand All @@ -63,7 +63,7 @@ that you want:
- :ref:`Working with HTML Components`
- :ref:`Working with Problem Components`
- :ref:`Working with Video Components`

After you add a component, it is not visible to learners until you
:ref:`publish the unit<Publish a Unit>`.

Expand All @@ -75,7 +75,7 @@ Edit a Component

To edit a component, you select the **Edit** icon.

.. image:: ../../../shared/building_and_running_chapters/Images/unit-edit.png
.. image:: ../../../shared/Images/unit-edit.png
:alt: Image of a unit with Edit icon circled

Then, follow instructions for the type of component you are editing.
Expand All @@ -97,7 +97,7 @@ To set the display name for a component, follow these steps.
#. Select **Configure**.
#. Edit the **Display Name** field.

.. image:: ../../../shared/building_and_running_chapters/Images/display-name.png
.. image:: ../../../shared/Images/display-name.png
:alt: Image of the Display Name field for a component.

4. Select **Save**.
Expand All @@ -119,7 +119,7 @@ content.
To duplicate a component, select the **Duplicate** icon in the component
header.

.. image:: ../../../shared/building_and_running_chapters/Images/unit-dup.png
.. image:: ../../../shared/Images/unit-dup.png
:alt: Image of a unit with Duplicate icon circled.

Then, follow instructions for the type of component you are editing.
Expand All @@ -135,14 +135,14 @@ until you :ref:`publish the unit<Publish a Unit>`.
Delete a Component
**********************

.. caution::
.. caution::
Be sure you want to delete the component. You cannot undo the deletion.

To delete a component, follow these steps.

#. Select the **Delete** icon in the component header.

.. image:: ../../../shared/building_and_running_chapters/Images/unit-delete.png
.. image:: ../../../shared/Images/unit-delete.png
:alt: Image of a unit with Delete icon circled.

2. When you receive the confirmation prompt, select **Yes, delete this
Expand All @@ -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:: ../../../shared/building_and_running_chapters/Images/component_container.png
.. image:: ../../../shared/Images/component_container.png
:alt: Image of a unit page with a parent component.


Expand All @@ -182,7 +182,7 @@ videos, or problems are in the child components.
A parent component has a display name. When the unit is private or in draft,
select **Edit** in the parent component to change the display name.

.. note::
.. note::
Parent components of a specific type, such as content experiments, have
additional attributes that you edit.

Expand All @@ -195,13 +195,13 @@ When you select **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:: ../../../shared/building_and_running_chapters/Images/child-components-a.png
.. image:: ../../../shared/Images/child-components-a.png
:alt: Image of an expanded child component.

Select the arrow next to a child component name to collapse it and hide the
component's contents.

.. image:: ../../../shared/building_and_running_chapters/Images/child-components.png
.. image:: ../../../shared/Images/child-components.png
:alt: Image of a child component page.

Select the arrow again to expand the component.
Expand All @@ -224,7 +224,7 @@ To add a child component, open and expand the parent component. Then, select
the component type that you want under **Add New Component** within the parent
component.

.. image:: ../../../shared/building_and_running_chapters/Images/AddNewComponent.png
.. image:: ../../../shared/Images/AddNewComponent.png
:alt: Image of adding a new component.

For more information, see the section for the specific component type that you
Expand All @@ -241,7 +241,7 @@ XML for Parent and Child Components
======================================

You develop parent and child components in XML, then import the XML course into
Studio to verify that the structure is as you intended.
Studio to verify that the structure is as you intended.

For more information about working with your course's XML files, including
information about terminology, see the `edX XML Tutorial <http://edx.readthedoc
Expand All @@ -261,7 +261,7 @@ The XML for the unit is as follows.
The ``<vertical url_name="131a499ddaa3474194c1aa2eced34455"/>`` element above
references the parent component file that contains the child components.

.. code-block:: xml
<vertical display_name="Parent Component">
Expand Down Expand Up @@ -297,11 +297,11 @@ The Learner View of Nested Components
For learners, all parent and child components appear on the unit page.
The following example shows the learner view of the unit described above.

.. image:: ../../../shared/building_and_running_chapters/Images/nested_components_student_view.png
.. image:: ../../../shared/Images/nested_components_student_view.png
:alt: Image of the learner's view of nested components.

.. note::
The visibility of nested components depends on the visibility of
.. note::
The visibility of nested components depends on the visibility of
the parent unit. The parent unit must be public for learners to see nested
components. For more information, see :ref:`Unit States and Visibility to Students`.

Expand All @@ -322,12 +322,12 @@ 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:: ../../../shared/building_and_running_chapters/Images/drag_child_component.png
.. image:: ../../../shared/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
moves to the same level as the parent.

.. note::
.. note::
For content experiments, you cannot drag a child component outside of a test
group.
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ As you develop your course, you work primarily in the edX Studio course
outline. This section includes the following information about working with
the course outline.

.. contents::
.. contents::
:local:
:depth: 1

Expand All @@ -33,14 +33,14 @@ To view the course outline, follow these steps.

When working in a course, to open the outline, from the **Content** menu,
select **Outline**.

The first time you view an outline for a course, it contains no content.

.. image:: ../../../shared/building_and_running_chapters/Images/outline_empty.png
The first time you view an outline for a course, it contains no content.

.. image:: ../../../shared/Images/outline_empty.png
:alt: An empty course outline.

You must :ref:`create the first section<Create a Section>`.

********************************************************
Example of a Developed Course in the Outline
********************************************************
Expand All @@ -49,7 +49,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:: ../../../shared/building_and_running_chapters/Images/outline-callouts.png
.. image:: ../../../shared/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.
Expand All @@ -59,7 +59,7 @@ As this example shows, the course is organized into the following levels.
#. :ref:`Units<Developing Course Units>`

:ref:`Components<Developing Course Components>` are not shown in the outline. You add or access components by selecting the units that contain them.

Use the links above for more information and instructions on working with each
type of object in the course. The topics in the rest of this section provides
more detail about the course outline.
Expand All @@ -72,7 +72,7 @@ The content you see in the outline in Studio is displayed to learners in the
**Courseware** page in the LMS. The following image shows how a learner sees
your course content.

.. image:: ../../../shared/building_and_running_chapters/Images/Course_Outline_LMS.png
.. image:: ../../../shared/Images/Course_Outline_LMS.png
:alt: Course content from learner's point of view.

.. _Navigating the Course Outline:
Expand All @@ -85,12 +85,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:: ../../../shared/building_and_running_chapters/Images/outline-expand-collapse.png
.. image:: ../../../shared/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:: ../../../shared/building_and_running_chapters/Images/outline-with-units.png
.. image:: ../../../shared/Images/outline-with-units.png
:alt: The outline with an expanded subsection.

Select the name of a unit to open the :ref:`unit page<Developing Course
Expand All @@ -111,13 +111,13 @@ You add sections, subsections, and units directly in the outline.
* To add a subsection to the end of the section, expand the section and select
**New Subsection**.

.. image:: ../../../shared/building_and_running_chapters/Images/outline-new-subsection.png
.. image:: ../../../shared/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 select
**New Unit**.

.. image:: ../../../shared/building_and_running_chapters/Images/outline-new-unit.png
.. image:: ../../../shared/Images/outline-new-unit.png
:alt: The outline with the New Subsection button circled.

The :ref:`unit<Developing Course Units>` page opens.
Expand Down Expand Up @@ -152,7 +152,7 @@ To modify settings for a section, subsection, or unit, select the **Configure**
icon for that object. In the following example, the **Configure** icon is
circled for a section, a subsection, and two units.

.. image:: ../../../shared/building_and_running_chapters/Images/settings-icons.png
.. image:: ../../../shared/Images/settings-icons.png
:alt: Configure icons in the course outline.

For more information, see the links above.
Expand All @@ -171,10 +171,10 @@ To publish new and changed units, select 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:: ../../../shared/building_and_running_chapters/Images/outline-publish-icons.png
.. image:: ../../../shared/Images/outline-publish-icons.png
:alt: Publishing icons in the course outline.

.. note::
.. note::
The **Publish** icon only appears when there is new or changed content within
the object.

Expand All @@ -199,27 +199,27 @@ right of 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:: ../../../shared/building_and_running_chapters/Images/outline-drag-select.png
.. image:: ../../../shared/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.
Then, click and drag the object to the location that you want.

If you expanded the section or subsection you are moving the object to, when
you move the object, a blue line indicates where the object will land when you
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:: ../../../shared/building_and_running_chapters/Images/outline-drag-new-location.png
:alt: A subsection being dragged to a new section.
.. image:: ../../../shared/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,
the outline of that section or subsection turns blue when you have moved the
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:: ../../../shared/building_and_running_chapters/Images/outline-drag-new-location-collapsed.png
.. image:: ../../../shared/Images/outline-drag-new-location-collapsed.png
:alt: A subsection being dragged to a new section.

.. note:: When you move a subsection to a different section, the release date
Expand All @@ -233,14 +233,14 @@ Delete Content in the Course Outline

You delete sections, subsections, and units from the course outline.

.. warning::
.. warning::
You cannot restore course content after you delete it. To ensure you do not
delete content you may need later, you can move any unused content to a
section in your course that you set to never release.

Select the **Delete** icon in the box for the object you want to delete.

.. image:: ../../../shared/building_and_running_chapters/Images/outline-delete.png
.. image:: ../../../shared/Images/outline-delete.png
:alt: The outline with Delete icons circled.

You are prompted to confirm the deletion.
Expand Down
Loading

0 comments on commit 1e33b6f

Please sign in to comment.