{"action":"created","comment":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/71773876","id":71773876,"diff_hunk":"@@ -142,72 +193,65 @@ Descriptions of the toolbar options follow.\n \r\n .. _Advanced Editor:\r\n \r\n-===================\r\n+====================\r\n The Advanced Editor\r\n-===================\r\n+====================\r\n \r\n-The advanced editor shows the OLX markup for a problem. Templates for some\r\n-problem types, such as math expression input, open directly in the advanced\r\n-editor.\r\n+The advanced editor is an XML editor that shows the OLX markup for a problem.\r\n+The following advanced problem types open in the advanced editor.\r\n \r\n-The following image shows the multiple choice problem above in the advanced\r\n-editor instead of the simple editor.\r\n+* :ref:`Circuit Schematic Builder`\r\n \r\n-.. image:: ../../../shared/images/MultipleChoice_AdvancedEditor.png\r\n- :alt: An image of a problem in the advanced editor.\r\n- :width: 600\r\n+* :ref:`Custom JavaScript Display and Grading<Custom JavaScript>`\r\n \r\n-The following problem templates open in the advanced editor.\r\n+* :ref:`Custom Python-Evaluated Input<Write Your Own Grader>`\r\n \r\n-* :ref:`Circuit Schematic Builder` In circuit schematic problems, learners\r\n-  create and modify circuits on an interactive grid and submit computer-\r\n-  generated analyses of the circuits for grading.\r\n+* :ref:`Drag and Drop`\r\n \r\n-* :ref:`Custom JavaScript` With custom JavaScript problems, you can create a\r\n-  custom problem or tool that uses JavaScript and add it directly into Studio.\r\n+* :ref:`Image Mapped Input`\r\n \r\n-* :ref:`Drag and Drop` Drag and drop problems require learners to drag text or\r\n-  objects to a specific location on an image.\r\n+* :ref:`Math Expression Input`\r\n \r\n-* :ref:`Image Mapped Input` Image mapped input problems require learners to\r\n-  select a specific location on an image.\r\n+* :ref:`Problem with Adaptive Hint`\r\n \r\n-* :ref:`Math Expression Input` Math expression input problems require learners\r\n-  to enter a mathematical expression as text, such as e=m\\*c^2.\r\n+Blank advanced problems do not provide an example problem, but they also open\r\n+in the advanced editor by default.\r\n \r\n-* :ref:`Problem with Adaptive Hint` These problems can give learners feedback\r\n-  or hints based on their responses. Problems with adaptive hints can be text\r\n-  input or multiple choice problems.\r\n+The following image shows the OLX markup in the advanced editor for the same\r\n+example multiple choice problem that is shown in the simple editor above.\r\n \r\n-* :ref:`Problem Written in LaTeX` This problem type allows you to convert\r\n-  problems that you previously wrote in LaTeX into the edX format. Note that\r\n-  this problem type is a prototype, and is not supported.\r\n+.. image:: ../../../shared/images/MultipleChoice_AdvancedEditor.png\r\n+ :alt: An example multiple choice problem in the advanced editor.\r\n+ :width: 600\r\n \r\n-* :ref:`Write Your Own Grader` Custom Python-evaluated input (also called\r\n-  \"write-your-own-grader\" problems evaluate learners' responses using an\r\n-  embedded Python script that you create. These problems can be of any type.\r\n+For more information about the OLX markup to use for a problem, see the topic\r\n+that describes that problem type.\r\n \r\n .. _Problem Settings:\r\n \r\n-******************\r\n-Problem Settings\r\n-******************\r\n+****************************************\r\n+Defining Settings for Problem Components\r\n+****************************************\r\n \r\n-In addition to the text of the problem, problems that you create using a\r\n-problem component have the following settings. To access these settings you\r\n-select **Settings** in the component editor.\r\n+In addition to the text of the problem and its markdown formatting or OLX\r\n+markup, you define the following settings for problem components. To access\r\n+these settings, you edit the problem and then select **Settings**.\r\n \r\n .. contents::\r\n   :local:\r\n   :depth: 1\r\n \r\n+If you do not edit these settings, default values are supplied for your\r\n+problems.\r\n+\r\n ===============\r\n Display Name\r\n ===============\r\n \r\n This setting indicates the name of your problem. This name appears as a heading\r\n above the problem in the LMS, and it identifies the problem for you in\r\n-Insights.\r\n+Insights. Unique, descriptive display names help you and your learners identify\r","path":"en_us/shared/course_components/create_problem.rst","position":358,"original_position":358,"commit_id":"4c6e55b58a7fc9bbfb9f09fad1252798c583ccd6","original_commit_id":"4c6e55b58a7fc9bbfb9f09fad1252798c583ccd6","user":{"login":"lamagnifica","id":6392274,"avatar_url":"https://avatars.githubusercontent.com/u/6392274?v=3","gravatar_id":"","url":"https://api.github.com/users/lamagnifica","html_url":"https://github.com/lamagnifica","followers_url":"https://api.github.com/users/lamagnifica/followers","following_url":"https://api.github.com/users/lamagnifica/following{/other_user}","gists_url":"https://api.github.com/users/lamagnifica/gists{/gist_id}","starred_url":"https://api.github.com/users/lamagnifica/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/lamagnifica/subscriptions","organizations_url":"https://api.github.com/users/lamagnifica/orgs","repos_url":"https://api.github.com/users/lamagnifica/repos","events_url":"https://api.github.com/users/lamagnifica/events{/privacy}","received_events_url":"https://api.github.com/users/lamagnifica/received_events","type":"User","site_admin":false},"body":"because in backwards world, we can't actually have EDIT CHECKS in the UI to make sure that people do the right thing!!!\r\n(did I say that out loud?)\r\n","created_at":"2016-07-21T19:46:30Z","updated_at":"2016-07-21T19:46:30Z","html_url":"https://github.com/edx/edx-documentation/pull/1132#discussion_r71773876","pull_request_url":"https://api.github.com/repos/edx/edx-documentation/pulls/1132","_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/71773876"},"html":{"href":"https://github.com/edx/edx-documentation/pull/1132#discussion_r71773876"},"pull_request":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/1132"}}},"pull_request":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/1132","id":78223755,"html_url":"https://github.com/edx/edx-documentation/pull/1132","diff_url":"https://github.com/edx/edx-documentation/pull/1132.diff","patch_url":"https://github.com/edx/edx-documentation/pull/1132.patch","issue_url":"https://api.github.com/repos/edx/edx-documentation/issues/1132","number":1132,"state":"open","locked":false,"title":"Revises default problem vs advanced ex&tool components","user":{"login":"lamagnifica","id":6392274,"avatar_url":"https://avatars.githubusercontent.com/u/6392274?v=3","gravatar_id":"","url":"https://api.github.com/users/lamagnifica","html_url":"https://github.com/lamagnifica","followers_url":"https://api.github.com/users/lamagnifica/followers","following_url":"https://api.github.com/users/lamagnifica/following{/other_user}","gists_url":"https://api.github.com/users/lamagnifica/gists{/gist_id}","starred_url":"https://api.github.com/users/lamagnifica/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/lamagnifica/subscriptions","organizations_url":"https://api.github.com/users/lamagnifica/orgs","repos_url":"https://api.github.com/users/lamagnifica/repos","events_url":"https://api.github.com/users/lamagnifica/events{/privacy}","received_events_url":"https://api.github.com/users/lamagnifica/received_events","type":"User","site_admin":false},"body":"## [DOC-3159](https://openedx.atlassian.net/browse/DOC-3159)\r\n\r\nDoc team, especially @catong , please expedite.\r\n\r\nPrepares for a11y changes to capa problems (first tranche).\r\n- revises how we introduce the problem types added by the problem component (core set, available to all course teams by deffault) vs. the exercises and tools that can be enabled, and that are then added using the HTML, Advanced, or problem components.\r\n- streamlines the simple vs. advanced editor default \r\n- makes CAPA uppercase\r\n- revises how you include multiple questions in a problem\r\n- removes repetitive info on problem randomization\r\n- moves a topic on course outline terminology differences to a (potentially) more relevant place in the import-export section\r\n\r\nAdditional changes in the topics for each of the CAPA problem types, particularly the \"common\" ones, to come in a follow on PR.\r\n\r\n### Reviewers\r\n\r\nPossible roles follow. PR submitter checks the boxes after each reviewer finishes and gives :+1:. \r\n\r\n- [ ] Doc team review (dev edit): @catong @srpearce @pdesjardins \r\n\r\nFYI: @sstack22 \r\n\r\n### Testing\r\n\r\n- [ ] Ran ./run_tests.sh without warnings or errors\r\n\r\n### Post-review\r\n\r\n- [ ] Add description to release notes task as a comment\r\n- [ ] Squash commits\r\n\r\n","created_at":"2016-07-20T21:36:18Z","updated_at":"2016-07-21T19:46:30Z","closed_at":null,"merged_at":null,"merge_commit_sha":"81440cf6a6c0ac6cd562aaa6a1117ac2ea49de06","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/edx/edx-documentation/pulls/1132/commits","review_comments_url":"https://api.github.com/repos/edx/edx-documentation/pulls/1132/comments","review_comment_url":"https://api.github.com/repos/edx/edx-documentation/pulls/comments{/number}","comments_url":"https://api.github.com/repos/edx/edx-documentation/issues/1132/comments","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/4c6e55b58a7fc9bbfb9f09fad1252798c583ccd6","head":{"label":"edx:ahodges/problem_component_revisions","ref":"ahodges/problem_component_revisions","sha":"4c6e55b58a7fc9bbfb9f09fad1252798c583ccd6","user":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"repo":{"id":23839256,"name":"edx-documentation","full_name":"edx/edx-documentation","owner":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/edx/edx-documentation","description":"For published versions of the edX documentation, visit:","fork":false,"url":"https://api.github.com/repos/edx/edx-documentation","forks_url":"https://api.github.com/repos/edx/edx-documentation/forks","keys_url":"https://api.github.com/repos/edx/edx-documentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/edx/edx-documentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/edx/edx-documentation/teams","hooks_url":"https://api.github.com/repos/edx/edx-documentation/hooks","issue_events_url":"https://api.github.com/repos/edx/edx-documentation/issues/events{/number}","events_url":"https://api.github.com/repos/edx/edx-documentation/events","assignees_url":"https://api.github.com/repos/edx/edx-documentation/assignees{/user}","branches_url":"https://api.github.com/repos/edx/edx-documentation/branches{/branch}","tags_url":"https://api.github.com/repos/edx/edx-documentation/tags","blobs_url":"https://api.github.com/repos/edx/edx-documentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/edx/edx-documentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/edx/edx-documentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/edx/edx-documentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/{sha}","languages_url":"https://api.github.com/repos/edx/edx-documentation/languages","stargazers_url":"https://api.github.com/repos/edx/edx-documentation/stargazers","contributors_url":"https://api.github.com/repos/edx/edx-documentation/contributors","subscribers_url":"https://api.github.com/repos/edx/edx-documentation/subscribers","subscription_url":"https://api.github.com/repos/edx/edx-documentation/subscription","commits_url":"https://api.github.com/repos/edx/edx-documentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/edx/edx-documentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/edx/edx-documentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/edx/edx-documentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/edx/edx-documentation/contents/{+path}","compare_url":"https://api.github.com/repos/edx/edx-documentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/edx/edx-documentation/merges","archive_url":"https://api.github.com/repos/edx/edx-documentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/edx/edx-documentation/downloads","issues_url":"https://api.github.com/repos/edx/edx-documentation/issues{/number}","pulls_url":"https://api.github.com/repos/edx/edx-documentation/pulls{/number}","milestones_url":"https://api.github.com/repos/edx/edx-documentation/milestones{/number}","notifications_url":"https://api.github.com/repos/edx/edx-documentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/edx/edx-documentation/labels{/name}","releases_url":"https://api.github.com/repos/edx/edx-documentation/releases{/id}","deployments_url":"https://api.github.com/repos/edx/edx-documentation/deployments","created_at":"2014-09-09T15:29:04Z","updated_at":"2016-07-04T03:40:08Z","pushed_at":"2016-07-21T19:27:27Z","git_url":"git://github.com/edx/edx-documentation.git","ssh_url":"git@github.com:edx/edx-documentation.git","clone_url":"https://github.com/edx/edx-documentation.git","svn_url":"https://github.com/edx/edx-documentation","homepage":" http://docs.edx.org","size":106382,"stargazers_count":43,"watchers_count":43,"language":"Makefile","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":139,"mirror_url":null,"open_issues_count":23,"forks":139,"open_issues":23,"watchers":43,"default_branch":"master"}},"base":{"label":"edx:master","ref":"master","sha":"440e06fe2b2611d095d5774f2aa801b22bcbe14e","user":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"repo":{"id":23839256,"name":"edx-documentation","full_name":"edx/edx-documentation","owner":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/edx/edx-documentation","description":"For published versions of the edX documentation, visit:","fork":false,"url":"https://api.github.com/repos/edx/edx-documentation","forks_url":"https://api.github.com/repos/edx/edx-documentation/forks","keys_url":"https://api.github.com/repos/edx/edx-documentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/edx/edx-documentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/edx/edx-documentation/teams","hooks_url":"https://api.github.com/repos/edx/edx-documentation/hooks","issue_events_url":"https://api.github.com/repos/edx/edx-documentation/issues/events{/number}","events_url":"https://api.github.com/repos/edx/edx-documentation/events","assignees_url":"https://api.github.com/repos/edx/edx-documentation/assignees{/user}","branches_url":"https://api.github.com/repos/edx/edx-documentation/branches{/branch}","tags_url":"https://api.github.com/repos/edx/edx-documentation/tags","blobs_url":"https://api.github.com/repos/edx/edx-documentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/edx/edx-documentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/edx/edx-documentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/edx/edx-documentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/{sha}","languages_url":"https://api.github.com/repos/edx/edx-documentation/languages","stargazers_url":"https://api.github.com/repos/edx/edx-documentation/stargazers","contributors_url":"https://api.github.com/repos/edx/edx-documentation/contributors","subscribers_url":"https://api.github.com/repos/edx/edx-documentation/subscribers","subscription_url":"https://api.github.com/repos/edx/edx-documentation/subscription","commits_url":"https://api.github.com/repos/edx/edx-documentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/edx/edx-documentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/edx/edx-documentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/edx/edx-documentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/edx/edx-documentation/contents/{+path}","compare_url":"https://api.github.com/repos/edx/edx-documentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/edx/edx-documentation/merges","archive_url":"https://api.github.com/repos/edx/edx-documentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/edx/edx-documentation/downloads","issues_url":"https://api.github.com/repos/edx/edx-documentation/issues{/number}","pulls_url":"https://api.github.com/repos/edx/edx-documentation/pulls{/number}","milestones_url":"https://api.github.com/repos/edx/edx-documentation/milestones{/number}","notifications_url":"https://api.github.com/repos/edx/edx-documentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/edx/edx-documentation/labels{/name}","releases_url":"https://api.github.com/repos/edx/edx-documentation/releases{/id}","deployments_url":"https://api.github.com/repos/edx/edx-documentation/deployments","created_at":"2014-09-09T15:29:04Z","updated_at":"2016-07-04T03:40:08Z","pushed_at":"2016-07-21T19:27:27Z","git_url":"git://github.com/edx/edx-documentation.git","ssh_url":"git@github.com:edx/edx-documentation.git","clone_url":"https://github.com/edx/edx-documentation.git","svn_url":"https://github.com/edx/edx-documentation","homepage":" http://docs.edx.org","size":106382,"stargazers_count":43,"watchers_count":43,"language":"Makefile","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":139,"mirror_url":null,"open_issues_count":23,"forks":139,"open_issues":23,"watchers":43,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/1132"},"html":{"href":"https://github.com/edx/edx-documentation/pull/1132"},"issue":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/1132"},"comments":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/1132/comments"},"review_comments":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/1132/comments"},"review_comment":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/1132/commits"},"statuses":{"href":"https://api.github.com/repos/edx/edx-documentation/statuses/4c6e55b58a7fc9bbfb9f09fad1252798c583ccd6"}}}}
{"actor":{"display_login":"lamagnifica"}}