It's hard to find marking guides in Learn

[wbamberg]

In the original Learn area assessments, people weren't directed to the marking guides: the idea was that they would try the assessment, then ask for feedback or help in Discourse. This didn't work too well, so https://github.com/mdn/content/pull/29139 removed the bits sending people to Discourse, and added a way for people to find the marking guides so they could self-assess.

This seems like a good idea but IMO it's much too hard to find out where the marking guides are. The information is AFAICS only in the Learn landing page (https://developer.mozilla.org/en-US/docs/Learn#tasks_and_assessments), which means that to know where they are, someone really has to start at the start and read everything, which noone does.

For instance, if someone wants to learn JS they might start at https://developer.mozilla.org/en-US/docs/Learn, see "Where to start", find the JS entry, go straight to https://developer.mozilla.org/en-US/docs/Learn/JavaScript/First_steps and start reading. Now they will have no idea how to find marking guides, because they didn't read the whole landing page.

Can we have a link to the relevant marking guide on every assessment page?

[bsmth]

I think that's a good idea. We have 26 marking.md files in the learning-area repo:

./html/multimedia-and-embedding/tasks/images/marking.md
./html/multimedia-and-embedding/tasks/media-embed/marking.md
./html/forms/tasks/form-validation/marking.md
./html/forms/tasks/other-controls/marking.md
./html/forms/tasks/styling-basics/marking.md
./html/forms/tasks/html5-controls/marking.md
./html/forms/tasks/form-structure/marking.md
./html/forms/tasks/advanced-styling/marking.md
./html/forms/tasks/basic-controls/marking.md
./html/introduction-to-html/tasks/advanced-text/marking.md
./html/introduction-to-html/tasks/links/marking.md
./html/introduction-to-html/tasks/basic-text/marking.md
./javascript/oojs/tasks/object-basics/marking.md
./javascript/oojs/tasks/oojs/marking.md
./javascript/oojs/tasks/json/marking.md
./javascript/introduction-to-js-1/tasks/strings/marking.md
./javascript/introduction-to-js-1/tasks/math/marking.md
./javascript/introduction-to-js-1/tasks/variables/marking.md
./javascript/introduction-to-js-1/tasks/arrays/marking.md
./javascript/building-blocks/tasks/conditionals/marking.md
./javascript/building-blocks/tasks/functions/marking.md
./javascript/building-blocks/tasks/loops/marking.md
./javascript/building-blocks/tasks/events/marking.md
./accessibility/tasks/html-css/css/marking.md
./accessibility/tasks/html-css/html/marking.md
./accessibility/tasks/html-css/aria/marking.md

https://github.com/search?q=repo%3Amdn%2Flearning-area%20marking.md&type=code

So I guess that's 26 tasks to link out from.

[wbamberg]

Unfortunately we also have "marking-guide.md" : https://github.com/mdn/learning-area/blob/main/css/styling-boxes/cool-information-box-finished/marking-guide.md 😭 .

I count 59 pages with "learn-module-assessment" page type:

• [ ] https://developer.mozilla.org/en-US/docs/learn/server-side/django/django_assessment_blog/
• [ ] https://developer.mozilla.org/en-US/docs/learn/accessibility/css_and_javascript/test_your_skills_colon__css_and_javascript_accessibility/
• [ ] https://developer.mozilla.org/en-US/docs/learn/accessibility/wai-aria_basics/test_your_skills_colon__wai-aria/
• [ ] https://developer.mozilla.org/en-US/docs/learn/accessibility/accessibility_troubleshooting/
• [ ] https://developer.mozilla.org/en-US/docs/learn/accessibility/test_your_skills_colon__html_accessibility/
• [ ] https://developer.mozilla.org/en-US/docs/learn/javascript/first_steps/test_your_skills_colon__arrays/
• [ ] https://developer.mozilla.org/en-US/docs/learn/javascript/first_steps/test_your_skills_colon__math/
• [ ] https://developer.mozilla.org/en-US/docs/learn/javascript/first_steps/test_your_skills_colon__strings/
• [ ] https://developer.mozilla.org/en-US/docs/learn/javascript/first_steps/test_your_skills_colon__variables/
• [ ] https://developer.mozilla.org/en-US/docs/learn/javascript/first_steps/silly_story_generator/
• [ ] https://developer.mozilla.org/en-US/docs/learn/javascript/objects/adding_bouncing_balls_features/
• [ ] https://developer.mozilla.org/en-US/docs/learn/javascript/objects/test_your_skills_colon__object_basics/
• [ ] https://developer.mozilla.org/en-US/docs/learn/javascript/objects/test_your_skills_colon__object-oriented_javascript/
• [ ] https://developer.mozilla.org/en-US/docs/learn/javascript/objects/test_your_skills_colon__json/
• [ ] https://developer.mozilla.org/en-US/docs/learn/javascript/building_blocks/image_gallery/
• [ ] https://developer.mozilla.org/en-US/docs/learn/javascript/building_blocks/test_your_skills_colon__events/
• [ ] https://developer.mozilla.org/en-US/docs/learn/javascript/building_blocks/test_your_skills_colon__loops/
• [ ] https://developer.mozilla.org/en-US/docs/learn/javascript/building_blocks/test_your_skills_colon__functions/
• [ ] https://developer.mozilla.org/en-US/docs/learn/javascript/building_blocks/test_your_skills_colon__conditionals/
• [ ] https://developer.mozilla.org/en-US/docs/learn/javascript/asynchronous/sequencing_animations/
• [ ] https://developer.mozilla.org/en-US/docs/learn/html/introduction_to_html/test_your_skills_colon__links/
• [ ] https://developer.mozilla.org/en-US/docs/learn/html/introduction_to_html/structuring_a_page_of_content/
• [ ] https://developer.mozilla.org/en-US/docs/learn/html/introduction_to_html/test_your_skills_colon__advanced_html_text/
• [ ] https://developer.mozilla.org/en-US/docs/learn/html/introduction_to_html/marking_up_a_letter/
• [ ] https://developer.mozilla.org/en-US/docs/learn/html/introduction_to_html/test_your_skills_colon__html_text_basics/
• [ ] https://developer.mozilla.org/en-US/docs/learn/html/multimedia_and_embedding/mozilla_splash_page/
• [ ] https://developer.mozilla.org/en-US/docs/learn/html/multimedia_and_embedding/video_and_audio_content/test_your_skills_colon__multimedia_and_embedding/
• [ ] https://developer.mozilla.org/en-US/docs/learn/html/multimedia_and_embedding/images_in_html/test_your_skills_colon__html_images/
• [ ] https://developer.mozilla.org/en-US/docs/mdn/writing_guidelines/page_structures/page_types/page_type_key/
• [ ] https://developer.mozilla.org/en-US/docs/learn/css/css_layout/grid_skills/
• [ ] https://developer.mozilla.org/en-US/docs/learn/css/css_layout/fundamental_layout_comprehension/
• [ ] https://developer.mozilla.org/en-US/docs/learn/css/css_layout/position_skills/
• [ ] https://developer.mozilla.org/en-US/docs/learn/css/css_layout/flexbox_skills/
• [ ] https://developer.mozilla.org/en-US/docs/learn/css/css_layout/rwd_skills/
• [ ] https://developer.mozilla.org/en-US/docs/learn/css/css_layout/floats_skills/
• [ ] https://developer.mozilla.org/en-US/docs/learn/css/css_layout/multicol_skills/
• [ ] https://developer.mozilla.org/en-US/docs/learn/css/styling_text/typesetting_a_homepage/
• [ ] https://developer.mozilla.org/en-US/docs/learn/css/building_blocks/tables_tasks/
• [ ] https://developer.mozilla.org/en-US/docs/learn/css/building_blocks/overflow_tasks/
• [ ] https://developer.mozilla.org/en-US/docs/learn/css/building_blocks/sizing_tasks/
• [ ] https://developer.mozilla.org/en-US/docs/learn/css/building_blocks/cascade_tasks/
• [ ] https://developer.mozilla.org/en-US/docs/learn/css/building_blocks/selectors/selectors_tasks/
• [ ] https://developer.mozilla.org/en-US/docs/learn/css/building_blocks/images_tasks/
• [ ] https://developer.mozilla.org/en-US/docs/learn/css/building_blocks/values_tasks/
• [ ] https://developer.mozilla.org/en-US/docs/learn/css/building_blocks/creating_fancy_letterheaded_paper/
• [ ] https://developer.mozilla.org/en-US/docs/learn/css/building_blocks/test_your_skills_backgrounds_and_borders/
• [ ] https://developer.mozilla.org/en-US/docs/learn/css/building_blocks/a_cool_looking_box/
• [ ] https://developer.mozilla.org/en-US/docs/learn/css/building_blocks/writing_modes_tasks/
• [ ] https://developer.mozilla.org/en-US/docs/learn/css/building_blocks/fundamental_css_comprehension/
• [ ] https://developer.mozilla.org/en-US/docs/learn/css/building_blocks/box_model_tasks/
• [ ] https://developer.mozilla.org/en-US/docs/learn/css/first_steps/styling_a_biography_page/
• [ ] https://developer.mozilla.org/en-US/docs/learn/forms/test_your_skills_colon__html5_controls/
• [ ] https://developer.mozilla.org/en-US/docs/learn/forms/test_your_skills_colon__basic_controls/
• [ ] https://developer.mozilla.org/en-US/docs/learn/forms/test_your_skills_colon__advanced_styling/
• [ ] https://developer.mozilla.org/en-US/docs/learn/forms/test_your_skills_colon__form_validation/
• [ ] https://developer.mozilla.org/en-US/docs/learn/forms/test_your_skills_colon__form_structure/
• [ ] https://developer.mozilla.org/en-US/docs/learn/forms/test_your_skills_colon__styling_basics/
• [ ] https://developer.mozilla.org/en-US/docs/learn/forms/test_your_skills_colon__other_controls/
• [ ] https://developer.mozilla.org/en-US/docs/learn/mathml/first_steps/three_famous_mathematical_formulas/

Not all of them have marking guides but they all might.

Perhaps if I make a PR for one of them so we can iterate on a design for it?