Muhammad Ahsan Mahfuz k22044399 Individual Project

[AhsanM1470]

Summary

This pull request integrates instructions directly into the MDENet Education Platform via two new features: an instruction panel and interactive guide.

Instruction Panel

• Added as a new utility panel.
• Loads content from a Markdown instruction file, located in the same repository as the activity configuration file.
• Includes checkboxes on instruction steps for learners to manually track their progress.
• Includes a progress bar that updates automatically as steps are checked off.

Interactive Guide

• Introduces draggable text bubbles to display instruction steps and guide learners through the activity.
• Uses metadata comments defined in the instruction markdown file to control behaviour.
• Metadata defines which panel a text bubble's tell should point to, and which panels to spotlight while the rest of the screen is dimmed.

[szschaler]

Closes #208.

[szschaler]

Many thanks, @AhsanM1470 for submitting this PR. Could you please update your branch based on the latest base branch to see if this causes any issues?

I'm aware that our tests are currently failing on this PR. This seems to be to do with how we have set up the GitHub Action rather than with any actual failures in the tests. @aryaei2000, could you look into this at some point, please?

[AhsanM1470]

Thank you for your response @szschaler. I have updated my branch, and all the features and unit tests are working correctly on my end. Please let me know if everything looks good to you or if you need anything else.

[szschaler]

I notice that some of the tests don't seem to run successfully and this doesn't look like it's the issue with uploading test reports, but an actual issue with the tests. @AhsanM1470, could you take a look at the check reports and see if you can work out what's going on here?

[AhsanM1470]

@szschaler I looked through the reports and saw the headless Firefox tests were failing. I think the failures have something to do with the HTML reporter plugin rather than the tests themselves. I updated both the jasmine-core and karma-jasmine-html-reporter packages to their latest versions locally, and now all the tests pass for me. Could you let me know if this fixes things on your end?

[szschaler]

Thanks. Could you add those changes to the branch here, please?

[AhsanM1470]

Sure thing, the changes have been added now

[szschaler]

Thanks, @AhsanM1470, this all looks good now. We are only left with errors from test reporting, which are due to GitHub permissions. We're aware of these and need to implement a solution separately...

[szschaler]

Partially addresses #233 .