ec1d9593d9
The OpenAPI docs (at /api-docs) for the modulestore_migrator app were missing some info, had duplicated info, and had some incorrect info. This brings them up to a state where they're accurate and should have all the info needed for someone to integrate with the API. For example: * We move the viewset class docstrings, which have the info needed for someone to POST correctly, into the actual POST handler method docstring. That way, they show up under that POST API endpoint rather than the GET API endpoint. * We fix the target keys to be v2 keys instead of v1 keys. We add detail on all the different migration options and why a user would want to specify them. * We fix the docs for `parameters` field to explain that they are always a _list_ of parameter objects, even for non-bulk migration tasks. This also removes confusing & unnecessary endpoints: * POST /api/modulestore_migrator/v1/bulk_migration/cancel * DELETE /api/modulestore_migrator/v1/migrations/<uuid> Finally, it sorts this endpoint to be newest-first: * POST /api/modulestore_migrator/v1/migrations Fixes: https://github.com/openedx/edx-platform/issues/37566
CMS
===
This directory contains code relating to the Open edX Content Management System ("CMS"). It allows learning content to be created, edited, versioned, and eventually published to the `Open edX Learning Mangement System <../lms>`_ ("LMS"). The main user-facing application that CMS powers is the `Open edX Studio <https://docs.openedx.org/en/latest/educators/concepts/open_edx_platform/what_is_studio.html>`_
See also
--------
* `CMS vs Studio terminology <../docs/decisions/0013-cms-vs-studio.rst>`_
* `CMS vs LMS boundaries <../docs/decisions/0005-studio-lms-subdomain-boundaries.rst>`_