Merge pull request #4164 from edx/ahodges/documentation/DOC392

Draft for DOC-392

docs/en_us/course_authors/source/change_log.rst

@@ -12,11 +12,13 @@ June, 2014
 
    * - Date
      - Change
+   * - 06/20/14
+     - Added a :ref:`Preface` with resources for course teams, developers, researchers, and students. 
    * - 06/18/14    
      - In the :ref:`View and download student data` section, updated the
        example report to include the new User ID column.
    * - 06/17/14   
-     - Added :ref:`TOC Transcripts` section to :ref:`Working with Video Components`.
+     - Added :ref:`Video TOC` section to :ref:`Working with Video Components`.
    * - 06/06/14   
      - Added a description of email task workflow states to the :ref:`Launch`
        section.

docs/en_us/course_authors/source/index.rst

@@ -12,6 +12,7 @@ Building and Running an edX Course
    :maxdepth: 2
 
    read_me
+   preface
    change_log
    getting_started/index
    building_course/index
@@ -19,4 +20,4 @@ Building and Running an edX Course
    exercises_tools/index
    releasing_course/index
    running_course/index
-   students/index
\ No newline at end of file
+   students/index

docs/en_us/course_authors/source/preface.rst

+.. include:: ../../shared/preface.rst
\ No newline at end of file

docs/en_us/course_authors/source/read_me.rst

@@ -2,11 +2,10 @@
 Read Me
 *******
 
-The edX *Building a Course with edX Studio* documentation is created
-using RST_ files and Sphinx_. You, the user community, can help update and revise
-this documentation project on GitHub::
+The edX *Building and Running an edX Course* guide is created
+using RST_ files and Sphinx_. You, the user community, can help update and revise this documentation project on GitHub::
 
-  https://github.com/edx/edx-platform/tree/master/docs/course_authors/source
+  https://github.com/edx/edx-platform/docs/en_us/course_authors/source
 
 To suggest a revision, fork the project, make changes in your fork, and submit
 a pull request back to the original project: this is known as the `GitHub Flow`_.

docs/en_us/data/source/index.rst

@@ -8,6 +8,7 @@ This document is intended for researchers and data czars at edX partner institut
    :maxdepth: 2
 
    read_me.rst
+   preface.rst
    internal_data_formats/change_log.rst
    internal_data_formats/data_czar.rst
    internal_data_formats/sql_schema.rst

docs/en_us/data/source/preface.rst

+.. include:: ../../shared/preface.rst
\ No newline at end of file

docs/en_us/data/source/read_me.rst

@@ -6,7 +6,7 @@ The *edX Research Guide* is created using RST_ files and Sphinx_. You, the
 user community, can help update and revise this documentation project on
 GitHub::
 
-  https://github.com/edx/edx-platform/tree/master/docs/course_authors/source
+  https://github.com/edx/edx-platform/docs/en_us/data/source
 
 To suggest a revision, fork the project, make changes in your fork, and submit
 a pull request back to the original project: this is known as the `GitHub Flow`_.

docs/en_us/developers/source/index.rst

@@ -15,6 +15,7 @@ Contents:
     :maxdepth: 2
 
     change_log
+    preface.rst
     overview.rst
     extending_platform/index
     xblocks.rst

docs/en_us/developers/source/preface.rst

+.. include:: ../../shared/preface.rst
\ No newline at end of file