Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file modified source/_images/educator_how_tos/library_content_available_tags.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified source/_images/educator_how_tos/library_content_tag_display.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -68,6 +68,13 @@ Export a taxonomy

#. Click :guilabel:`Export`. The file will export to your local machine.

.. seealso::

:ref:`create-flat-taxonomy`

:ref:`build-taxonomy-using-template`


**Maintenance chart**

+--------------+-------------------------------+----------------+--------------------------------+
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,32 +5,40 @@ Add Components to a Legacy Library

.. tags:: educator, how-to

To add new :ref:`components<Create and Manage Components>` to your library,
.. warning::

The Legacy Libraries feature will be supported through Ulmo, moving to
unsupported in Verawood. Ulmo will include a one-click migration feature that
will make it easy to convert a Legacy Library into the new Library interface.

See :ref:`Content Libraries Redesign Teak` for more information.

To add new :ref:`components<Create and Manage Components>` to your legacy library,
follow these steps.

#. Log in to Studio.

#. Select **Libraries**, then select the library that you want to add
#. Select **Legacy Libraries**, then select the legacy library that you want to add
components to.

#. Select **Add Component**, then select the component type that you want to
add under **Add New Component**.

For more information about the types of components you can add to a library,
For more information about the types of components you can add to a legacy library,
see these topics.

* :ref:`About Text Components<About Text Components>`
* :ref:`Working with Problem Components`
* :ref:`Working with Video Components`

After you add a component to a library, you can edit its settings. These
settings are retained when the component is selected from the library and used
After you add a component to a legacy library, you can edit its settings. These
settings are retained when the component is selected from the legacy library and used
in a course.

When a component from the library is used in a randomized content block, you
When a component from the legacy library is used in a randomized content block, you
can further edit the component as it exists in the unit, without affecting the
original version in the library. For details, refer to :ref:`Edit Components in
a Legacy Library` and :ref:`Get the Latest Version of Library Content <Get the Latest Version of Library Content>`.
original version in the legacy library. For details, refer to :ref:`Edit Components in
a Legacy Library` and :ref:`Get the Latest Version of Library Content <Get the Latest Version of Legacy Library Content>`.


.. seealso::
Expand Down Expand Up @@ -60,5 +68,7 @@ a Legacy Library` and :ref:`Get the Latest Version of Library Content <Get the L
+--------------+-------------------------------+----------------+--------------------------------+
| Review Date | Working Group Reviewer | Release |Test situation |
+--------------+-------------------------------+----------------+--------------------------------+
| 2025-07-31 | sarina | Teak | Deprecated |
+--------------+-------------------------------+----------------+--------------------------------+
| 07/01/2025 | Leira (Curricu.me) | Sumac | Pass |
+--------------+-------------------------------+----------------+--------------------------------+
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,9 @@ Add and Delete tags in Library content
Users must have "Author" or "Admin" permissions on a library to manage tags.
See :ref:`Add users to Libraries` for more detail.

At least one taxonomy must be enabled in order to tag content. See
:ref:`import-export-taxonomy` for details on importing taxonomies.

With the Content Tagging feature, authors and instructional designers are able
to add tags to their Library content. This includes the ability to tag any
individual blocks like problems and videos.
Expand Down Expand Up @@ -79,10 +82,18 @@ Delete tags from Library content

:ref:`Build a Collection in a Library`

:ref:`import-export-taxonomy`

:ref:`create-flat-taxonomy`

:ref:`build-taxonomy-using-template`

**Maintenance chart**

+--------------+-------------------------------+----------------+---------------------------------------------------------------+
| Review Date | Working Group Reviewer | Release |Test situation |
+--------------+-------------------------------+----------------+---------------------------------------------------------------+
| 2025-07-31 | sarina | Teak | Pass |
+--------------+-------------------------------+----------------+---------------------------------------------------------------+
| 07/02/2025 | Leira (Curricu.me) | Sumac | Fail (https://github.com/openedx/docs.openedx.org/issues/1187)|
+--------------+-------------------------------+----------------+---------------------------------------------------------------+
34 changes: 18 additions & 16 deletions source/educators/how-tos/course_development/create_library.rst
Original file line number Diff line number Diff line change
Expand Up @@ -17,44 +17,44 @@ that can be used in randomized assignments in your courses.

See :ref:`Content Libraries Redesign Teak` for more information.

To create a new library, follow these steps.
To create a new legacy library, follow these steps.

#. Log in to Studio.

#. Select **New Library**.
#. Select **Legacy Libraries**, then **New Library**.

#. Enter the required information for your new library, then select **Create**.
#. Enter the required information for your new legacy library, then select **Create**.

.. note:: Enter new library information carefully. The values in these
fields become part of the URL for your library, therefore the total
.. note:: Enter new legacy library information carefully. The values in these
fields become part of the URL for your legacy library, therefore the total
number of characters in the **Library Name**, **Organization**, and
**Library Code** fields must be 65 or fewer.

.. image:: /_images/educator_how_tos/ContentLibrary_NewCL.png
:alt: Image of the library creation page.
:alt: Image of the legacy library creation page.
:width: 600

- For **Library Name**, enter the public display name for your library.
- For **Library Name**, enter the public display name for your legacy library.
Choose a meaningful name that will help you and other course team members
to identify the library. For example, "Level 200 Math Problems". When you
add a randomized content block to a course unit, you use the library name
to specify this library as a source for the randomized assignment.
to identify the legacy library. For example, "Level 200 Math Problems". When you
add a randomized content block to a course unit, you use the legacy library name
to specify this legacy library as a source for the randomized assignment.

- For **Organization**, enter the identifier for your university. For
example, enter HarvardX or MITx. Do not include spaces or special
characters.

- For **Library Code**, enter an identifier for your library that is unique
- For **Library Code**, enter an identifier for your legacy library that is unique
within your organization. This code becomes part of the URL for your
library, so do not include spaces or special characters in the code.
legacy library, so do not include spaces or special characters in the code.

4. Select **Create**.

You see the new library, to which you can now add components. For information
about adding components to a library, see :ref:`Add Components to a Legacy Library`.
You see the new legacy library, to which you can now add components. For information
about adding components to a legacy library, see :ref:`Add Components to a Legacy Library`.

After you create a library, you are automatically assigned an **Admin** role
for the library. For information about adding other users to a library after
After you create a legacy library, you are automatically assigned an **Admin** role
for the legacy library. For information about adding other users to a legacy library after
you create it, see :ref:`Give Other Users Access to Your Legacy Library`.


Expand Down Expand Up @@ -85,5 +85,7 @@ you create it, see :ref:`Give Other Users Access to Your Legacy Library`.
+--------------+-------------------------------+----------------+--------------------------------+
| Review Date | Working Group Reviewer | Release |Test situation |
+--------------+-------------------------------+----------------+--------------------------------+
| 2025-07-31 | sarina | Teak | Deprecated |
+--------------+-------------------------------+----------------+--------------------------------+
| 07/01/2025 | Leira (Curricu.me) | Sumac | Pass |
+--------------+-------------------------------+----------------+--------------------------------+
18 changes: 14 additions & 4 deletions source/educators/how-tos/course_development/delete_library.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,16 +5,24 @@ Delete a Legacy Library

.. tags:: educator, how-to

You cannot delete a library. Instead, you can discontinue use of an unwanted
library. To do so, follow the next steps:
.. warning::

The Legacy Libraries feature will be supported through Ulmo, moving to
unsupported in Verawood. Ulmo will include a one-click migration feature that
will make it easy to convert a Legacy Library into the new Library interface.

See :ref:`Content Libraries Redesign Teak` for more information.

You cannot delete a legacy library. Instead, you can discontinue use of an unwanted
legacy library. To do so, follow the next steps:

#. First, make sure that none of its components are in use in
any courses.

#. Delete all components in the library.
#. Delete all components in the legacy library.

#. :ref:`Edit the name of the legacy library<Edit a Legacy Library>` to make it clear to other course team
members that the library should not be used as a source of randomized
members that the legacy library should not be used as a source of randomized
assignment content in courses.


Expand Down Expand Up @@ -45,5 +53,7 @@ assignment content in courses.
+--------------+-------------------------------+----------------+--------------------------------+
| Review Date | Working Group Reviewer | Release |Test situation |
+--------------+-------------------------------+----------------+--------------------------------+
| 2025-07-31 | sarina | Teak | Deprecated |
+--------------+-------------------------------+----------------+--------------------------------+
| 07/02/2025 | Leira (Curricu.me) | Sumac | Pass |
+--------------+-------------------------------+----------------+--------------------------------+
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ refer to the following topics.
these updates in the "source" library are not reflected in the course unless
you manually update the randomized content block in the course unit. For
details about updating library components used in your course to match the
latest version in the library, see :ref:`Get the Latest Version of Library
latest version in the library, see :ref:`Get the Latest Version of Legacy Library
Content`.


Expand Down
32 changes: 21 additions & 11 deletions source/educators/how-tos/course_development/edit_library.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,32 +5,40 @@ Edit a Legacy Library

.. tags:: educator, how-to

After you create a library, the only change you can make to the initial library
.. warning::

The Legacy Libraries feature will be supported through Ulmo, moving to
unsupported in Verawood. Ulmo will include a one-click migration feature that
will make it easy to convert a Legacy Library into the new Library interface.

See :ref:`Content Libraries Redesign Teak` for more information.

After you create a legacy library, the only change you can make to the initial legacy library
information is to the name. However, at any time, you can make changes to the
components in your library, including adding or deleting components or editing
components in your legacy library, including adding or deleting components or editing
the settings of components. For details about editing the contents of a
library, see :ref:`Edit Components in a Legacy Library` and :ref:`Add Components to a
legacy library, see :ref:`Edit Components in a Legacy Library` and :ref:`Add Components to a
Legacy Library`.

To change the name of a library, follow these steps.
To change the name of a legacy library, follow these steps.

#. Log in to Studio.

#. Select **Libraries**, then select the library whose name you want to edit.
#. Select **Legacy Libraries**, then select the legacy library whose name you want to edit.

#. Select the **Edit** icon next to the library name.
#. Select the **Edit** icon next to the legacy library name.

The library name field becomes editable.
The legacy library name field becomes editable.

.. image:: /_images/educator_how_tos/ContentLibrary_EditName.png
:alt: The Edit icon to the right of the Library Name.
:alt: The Edit icon to the right of the legacy library Name.
:width: 300

#. In the library name field, make edits or enter a new library name.
#. In the library name field, make edits or enter a new legacy library name.

#. Select anywhere outside the library name field to save your changes.
#. Select anywhere outside the legacy library name field to save your changes.

For details about giving other users access to the library, see :ref:`Give
For details about giving other users access to the legacy library, see :ref:`Give
Other Users Access to Your Legacy Library`.


Expand Down Expand Up @@ -61,5 +69,7 @@ Other Users Access to Your Legacy Library`.
+--------------+-------------------------------+----------------+--------------------------------+
| Review Date | Working Group Reviewer | Release |Test situation |
+--------------+-------------------------------+----------------+--------------------------------+
| 2025-07-31 | sarina | Teak | Deprecated |
+--------------+-------------------------------+----------------+--------------------------------+
| 07/01/2025 | Leira(Curricuu.me) | Sumac | Pass |
+--------------+-------------------------------+----------------+--------------------------------+
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ these topics.

* :ref:`View the Matching Components in a Randomized Content Block`
* :ref:`Edit Components in Randomized Content Blocks`
* :ref:`Get the Latest Version of Library Content`
* :ref:`Get the Latest Version of Legacy Library Content`
* :ref:`Preview Randomized Content in Student View`
* :ref:`View Specific Student Assigned Problems from Randomized Content Block`
* :ref:`Adjust Grades for a Problem from a Randomized Content Block`
Expand Down Expand Up @@ -154,7 +154,7 @@ do for any other component in your course.
components from a library, these changes are overwritten. Only changes to a
component's **Settings** tab are retained when you update the component.
For details about getting the latest versions of library content in a
randomized content block, see :ref:`Get the Latest Version of Library
randomized content block, see :ref:`Get the Latest Version of Legacy Library
Content`.

The settings of a component that is supplied in a randomized content block are
Expand All @@ -172,10 +172,10 @@ library, a **Clear** icon is shown next to the setting field.

Select **Clear** to restore the library default setting for that field.

.. _Get the Latest Version of Library Content:
.. _Get the Latest Version of Legacy Library Content:

Getting the Latest Version of Library Content
=============================================
Getting the Latest Version of Legacy Library Content
=======================================================

If you modify the contents of a library that is referenced by randomized
content blocks in one or more courses, those courses do not automatically use
Expand Down
Loading