Merge pull request #2943 from edx/sylvia/documentation/BLD-850

Consolidate information from data.edx.org, Appendix E, and problem types

docs/en_us/course_authors/source/create_problem_component.rst

@@ -428,10 +428,6 @@ Note that *problem randomization* is different from the **Randomization** settin
 
 .. note:: Creating problems with versions that can be randomized requires you to export your course, edit some of your course's XML files in a text editor, and then re-import your course. We recommend that you create a backup copy of your course before you do this. We also recommend that you only edit the files that will contain polls in the text editor if you're very familiar with editing XML.
 
-==========================
-Terminology
-==========================
-
 ===========
 Terminology
 ===========
@@ -561,3 +557,34 @@ students to go back and resubmit a problem.
 -  Delete the entire Problem component in Studio and create a new
    Problem component with the content and settings that you want. Then
    ask all your students to complete the new problem.
+
+.. _Problem XML:
+
+***********
+Problem XML
+***********
+
+XML tags are generally specific to a problem type. For example, only multiple choice problems contain the ``<multiplechoiceresponse>`` tag, and only drag and drop problems use the ``<draggable>`` tag. However, the following tags are common to most problems.
+
+.. list-table::
+   :widths: 20 80
+
+   * - ``<problem> </problem>``
+     - These must be the first and last tags for any content created in the Advanced
+       Editor in a Problem component.
+   * - ``<startouttext/>``
+     - The ``<startouttext />`` tag indicates the beginning of a line or block of text.
+   * - ``<endouttext/>``
+     - The ``<endouttext />`` tag indicates the end of a line or block of text.
+   * - ``<solution> <div class="detailed-solution"> </div> </solution>`` (optional)
+     - If you want to include more information in the problem, such as a detailed explanation of the problem's answer, you'll enter the text between the two ``<div>`` tags, which are inside the ``<solution>`` tags. (These tags do not have to be on the same line.)
+
+Additionally, several different problem types use the following tags.
+
+.. list-table::
+   :widths: 20 80
+
+   * - ``<textline>``
+     - Creates an answer space where students enter a response. Must contain a **size** attribute; may contain **label**, **math**, **correct_answer**. Used in text input and some custom Python-evaluated input problems.
+   * - ``<customresponse> </customresponse>``
+     -