Skip to content

Commit

Permalink
Add line about Parson's randomisation bug for numerical keys
Browse files Browse the repository at this point in the history
  • Loading branch information
smmercuri committed Aug 2, 2024
1 parent e87069a commit 5e6cf47
Showing 1 changed file with 1 addition and 1 deletion.
2 changes: 1 addition & 1 deletion doc/en/Authoring/Parsons.md
Original file line number Diff line number Diff line change
Expand Up @@ -119,7 +119,7 @@ To create a random order, you must define steps as Maxima objects using a `proof
2. Add in `proof_steps:random_permutation(proof_steps);` to the question variables.
3. Add in a question note such as `{@map(first, proof_steps)@}` to create a meaningful, minimal, question note giving the order of steps.

Note, if you randomly generate random variants it is _strongly recommended_ you use text-based keys. Keeping track of permuted numerical keys will be very difficult!
Currently, random generation using numerical keys (either as a numerical type `1` or a string type `"1"`) causes issues with random shuffling of steps; this is a bug which will be fixed in a future version.

## Block connection with Maxima

Expand Down

0 comments on commit 5e6cf47

Please sign in to comment.