Rework sum-of-multiples documentation

[kytrinyx]

This exercise is one of the focus exercises for 12in23.

This PR is part of our project of making our Practice Exercises more consistent and human. For more context please see this forum thread

We aim to merge this PR in roughly 72 hours, and then submit PRs to all tracks that have this exercise.

The main change is to frame the exercise within the context of a story.

[IsaacG]

To be honest, I find the old prose a lot easier to read. It surfaces the numbers/examples/details without having to parse all the prose. Would it make sense to have an example that is more numbers and less text?

[kytrinyx]

Do you have any suggestions for a pretext that adds color without all the verbosity? I really struggled with this one because I couldn't find a single down to earth, real world situation that would use this.

I don't like the old one at all, but I'm not married to this version at all. I would be open to just deprecating the exercise if we can't find a workable story.

[IsaacG]

I don't have a story suggestion and I'm perfectly fine with this one.

I think, in general, examples are much easier to read when they focus on the values and use less prose. Mixing the prose and example data makes the example much harder to follow and adds another layer of "word problem" reading comprehension.

- To find the unique multiples, we can combine these two sets of multiples and remove any duplicates: `{3, 5, 6, 9, 10, 12, 15, 18, 20}`
- The sum of all these unique multiples is: `3 + 5 + 6 + 9 + 10 + 12 + 15 + 18 + 20 = 98`
+ Find the unique multiples (combing the sets and removing duplicates): `{3, 5, 6, 9, 10, 12, 15, 18, 20}`
+ Sum the unique multiples: `3 + 5 + 6 + 9 + 10 + 12 + 15 + 18 + 20 = 98`

[kytrinyx]

examples are much easier to read when they focus on the values and use less prose

This is a really useful observation, and I'm adding it to my personal list of guidelines to follow when working on these.

I like your improvement here.

[kytrinyx]

What do you think of this?

-- The player completed level 20 and found two magical items with base values of 3 and 5.
-- To calculate the energy points earned by the player, we need to find all the unique multiples of these base values that are less than or equal to level 20.
-- For the base value of 3, the multiples less than or equal to 20 are: 3, 6, 9, 12, 15, 18, and 20.
-- For the base value of 5, the multiples less than or equal to 20 are: 5, 10, 15, and 20.
-- To find the unique multiples, we can combine these two sets of multiples and remove any duplicates: `{3, 5, 6, 9, 10, 12, 15, 18, 20}`
-- The sum of all these unique multiples is: `3 + 5 + 6 + 9 + 10 + 12 + 15 + 18 + 20 = 98`
+**The player completed level 20 and found two magical items with base values of 3 and 5.**
+
+To calculate the energy points earned by the player, we need to find all the unique multiples of these base values that are less than or equal to level 20.
+
+- Multiples of 3 up to 20: `{3, 6, 9, 12, 15, 18, 20}`
+- Multiples of 5 up to 20: `{5, 10, 15, 20}`
+- Combine the sets and remove duplicates: `{3, 5, 6, 9, 10, 12, 15, 18, 20}`
+- Sum the unique multiples: `3 + 5 + 6 + 9 + 10 + 12 + 15 + 18 + 20 = 98`
 - Therefore, the player earns **98** energy points for completing level 20 and finding the two magical items with base values of 3 and 5.

[IsaacG]

What do you think of this?

I think that's a lot simpler to read :) Thanks!

[kytrinyx]

Thanks @IsaacG. I've pushed that up!

[ee7]

I also can't think of a better story.

If we keep it, can we simplify it further? The old description is dry, but I personally find it much easier to read. However, I acknowlege that I'm probably not an representative reader.

Trying to be concrete, I think the introduction has a lot of nouns: Enchanted Expeditions, terrain, resources, materials, metals, fibers, wood, tools, gear, weapons, energy, levels, magical items.

Maybe we can remove some of those, without losing too much flavor? I think the reader only needs to know about: levels, magical items, base values, and energy.