Doc - First draft for shuffle changes to Building Course guide

[mhoeber]

No description provided.

[mhoeber]

@nparlante @cahrens first draft of shuffle update is at: http://draft-shuffle.readthedocs.org/en/latest/common_problems.html#shuffle-answers-in-a-multiple-choice-problem

I did this without actually running it, couldn't build a sandbox off of Nick's branch, caused errors, but wanted to get started. Will test when feasible.

[mhoeber]

@lamagnifica @srpearce can you look over new section in link above when you get a chance. this isn't in tomorrow's release, possibly next week.

[srpearce]

Looks great--except for the "you must edit the XML in the _The Advanced
Editor_http://draft-shuffle.readthedocs.org/en/latest/create_problem_component.html#advanced-editor
." problem that we run into sometimes. :-)

On Tue, Feb 11, 2014 at 10:16 AM, Mark Hoeber notifications@github.comwrote:

@lamagnifica https://github.com/lamagnifica @srpearcehttps://github.com/srpearcecan you look over new section in link above when you get a chance. this
isn't in tomorrow's release, possibly next week.

Reply to this email directly or view it on GitHubhttps://github.com/edx/edx-platform/pull/2550#issuecomment-34763564
.

[mhoeber]

@jaericson

[nparlante]

Hey Mark -- note that there is a markdown syntax for the shuffle
feature. It's mentioned at the end of my blurb on the capa PR. You
should certainly mention that, and indeed, maybe focus your examples on
the markdown form not the xml form. (Hat tip: Jane).

On 2/10/14 2:18 PM, Mark Hoeber wrote:

@nparlante https://github.com/nparlante @cahrens
https://github.com/cahrens first draft of shuffle update is at:
http://draft-shuffle.readthedocs.org/en/latest/common_problems.html#shuffle-answers-in-a-multiple-choice-problem

I did this without actually running it, couldn't build a sandbox off
of Nick's branch, caused errors, but wanted to get started. Will test
when feasible.

—
Reply to this email directly or view it on GitHub
https://github.com/edx/edx-platform/pull/2550#issuecomment-34689648.

[mhoeber]

All, updated with markup for shuffle, and xml details for targeted feedback and answer pools. Can you give it one more look over. Won't be merging until code is released on edx.org.

Thanks
Mark

[mhoeber]

@sarina

[cahrens]

Here is some feedback I gave Mark through HipChat:

I was reading through your documentation on Shuffle and Targeted Feedback before looking at the PR. DId your question (DO YOU STILL NEED SOLUTION ELEMENT) get addressed? http://draft-shuffle.readthedocs.org/en/latest/common_problems.html#shuffle-answers-in-a-multiple-ch...

Also, it looks like the "Answer Pools" section has some copy/paste errors (11.3.4.1)

And here, I would say "You do still use the instead of also
If the choices include only one correct answer, you do not have to use the explanation-id in either the choice or element. You also do use the element to wrap the element.

For targeted feedback, your example code does not work.
You have to have as the starting multiplechoiceresponse tag.

Your answer pool example doesn't work either.
answer-pool="4" should be in the choicegroup tag. For example,

<problem>
            <p>What is the correct answer?</p>
            <multiplechoiceresponse>
              <choicegroup type="MultipleChoice" answer-pool="4">

[sarina]

shouldn't this be "to configure answer pools"?

[mhoeber]

Comments addressed, all updated, rebased.

Shuffle: http://draft-shuffle.readthedocs.org/en/latest/common_problems.html#multiple-choice

Targeted Feedback: http://draft-shuffle.readthedocs.org/en/latest/common_problems.html#targeted-feedback-in-a-multiple-choice-problem

Answer Pools: http://draft-shuffle.readthedocs.org/en/latest/common_problems.html#answer-pools-in-a-multiple-choice-problem

[cahrens]

Typo-- feeback3.

[singingwolfboy]

@mhoeber Looks like this branch needs a rebase. Also, do you know when it's going to be merged?

[mhoeber]

@singingwolfboy Yes, will rebase it today. merging it depends on the standford shuffle feature being merged, which was postponed again.

[sarina]

Blocked by #1499