openedx / edx-platform

The Open edX LMS & Studio, powering education sites around the world!
https://openedx.org
GNU Affero General Public License v3.0
7.42k stars 3.88k forks source link

[DEPR]: Legacy Problem Editor #35256

Open kdmccormick opened 2 months ago

kdmccormick commented 2 months ago

Proposal Date

2024-08-08

Target Ticket Acceptance Date

2025-09-01

Earliest Open edX Named Release Without This Functionality

Teak - 2025-04

Rationale

The legacy ProblemBlock (aka "CAPA") editor is based on outdated frontend technologies that do not integrate well with the new React-based Studio micro-frontend. There is a newer React-based editor that replaces it. Supporting both editors is a major burden for maintenance and feature development.

Removal

The old pop-up modal Problem editor will be removed.

[ NEED: SCREENSHOT ]

[ NEED: CODE LINKS ]

Replacement

The full-screen React-based Problem editor is the replacement.

[ NEED: SCREENSHOT ]

CODE: https://github.com/openedx/frontend-lib-content-components/

Deprecation

We will warn about the pending deprecation in the Sumac release notes.

Migration

TBD

Additional Info

There is a known feature delta between the old editor and the new one. This includes:

[ NEED: SCREENSHOTS ]

Additional feedback on the new editor:

Task List

TBD

kdmccormick commented 2 months ago

@pdpinch , here's a DEPR for the old Problem editor as we discussed. You mentioned that there were more Problem-specific editor concerns--let's collect those here.

SIdnani commented 2 months ago

Some more specific feedback I have gathered comparing the Legacy Problem Editor to the MFE Editors:

  1. Ease of Copy-Paste: The Legacy Editor(Basic or Advanced) allowed you to copy-paste entire problems from text-editors outside the platform to build assessment items. As opposed to the MFE editor that requires you to copy-paste assessment items line by line into a form. A 10-item MCQ quiz with a standard 4 choices and solution and 2 hints goes from 10 copy-pastes actions from an external design doc to the Legacy Basic Editor and becomes 80 copy-paste actions with the addition of extra clicks to select the "correct" answer. This is a huge waste of time and will create errors.
  2. The building everything as a form is only useful to folks as a learning aid, the first time they attempt something. After that, bulk building becomes the norm. Not one Instructional Designer or SME across all the institutions I have worked ever wrote content in the CMS of any LMS. So the forms required to build items makes them shy away from building online assessments.
  3. Instructional Designers (IDs) often use a multi-step assessment items to hit one learning objective. These items have 1 submit button. For example: Putting an image, e.g. A Graph, with significant areas labeled a, b, c, etc., then 3 text-entry, or 3 numerical entry, or 3 drop-downs asking learners to identify, categorize, or compute values for each of those indicated areas. Sometimes IDs mix assessment types (Drop-downs, MCQ, Text-Entry, Numerical Entry) within one problem to hit different parts of the same learning objective and grade them as one whole.
  4. The Legacy Editor allowed multi-assessment items to be generated at the WYSIWYG-level vs. the MFE Editor that forces you through the process of creating only one problem with the form editor for non-technical users then you need to end up in the advanced editor to be able to do anything else. Note: You are required at that point to know the weeds of the XML to get the same problem created.
  5. Flexibility of formatting: Legacy Advanced Editor allowed you to implement and preview inline. This meant that you could compare your changes against other items in the Unit and re-format problems using HTML on the fly. You are not stuck with the default formatting available to an individual problem.
  6. All of the standard usability changes that applied to Text components applies here as well. Things like location within the course, publication status, and advanced editors require more effort to access when the new MFE editor navigates folks away from their content on the Unit page.
kdmccormick commented 1 month ago

Thank you @SIdnani. Noted on all counts.