Epic 1: UI Improvements to the Library Authoring Environment
Epic 2: Libraries support Collections (subsets of components)
Epic 3: Simplifying the “Use Existing Content” Workflow in Courses (formerly the “Library Block”)

...

Epic 2: Libraries support Collections (subsets of components)

Key user stories:

• As a content author, I don’t want to have to create a new Library every time I need to create a different pool of content for randomization.

• As a content author, I want to be able to create subsets of content within a Library with any media type (videos, text blocks, problem blocks, or any combination thereof) as a means of organizing my content, and without the expectation that I would ever need to randomize from it. For example, I want to organize a subset of videos on the same topic so that it’s easier for me to find them later when I want to use them.

• As a content author, I don’t want to lose the ability to create a subset of content (problems) to randomize from. I still use randomized problem sets for my exams and assignments. But I need an easier way to create these subsets and use them in one or multiple courses, because the current workflow is cumbersome.

...

• Authors can create subsets of components for the sake of grouping like components together as a method of content organization and management. 

  • For example, I want to create a subset of evergreen videos about how to do peer-reviews.

• Authors can create as many Collections in a Library as they wish.

• Authors can add as many components to a collection as they wish.

• Components can live in multiple collections.

• Collections can contain mixed media types (for example, a collection may contain video components, text blocks and problems all within the same collection).

• Basic keyword search within a collection

• Basic sort and filter

  • Sort alphabetical

  • Filter by tag

• [FUTURE STATE] When Libraries support units, subsections and section, collections may also contain any combination of components, units, sections and subsections. Note that a single unit or a single section is not considered a Collection. Rather, a Collection is comprised of multiple sections, multiple units, etc.

Do Libraries need to display publish status?

Library publish options:

• Publish all library

• Publish collection

• Publish component

How authors create Collections:

...

• Authors can view all of their Collections in one place within the Library.

• Authors can search for Collections in the same way they search for content. Collections turn up in search results, and authors can refine search results by collection.

  • Search results indicate whether the result is a component or a collection.

  • Eg, I conduct a free-text search for “algebra” and 239 results display, including individual components and collections. I can further refine my search for “collections only”.

• OUT OF SCOPE FOR NOW: Searching or refining searches within a collection. The assumption is that Collections will be small enough that complex search functionality within a Collection probably isn’t necessary.

Epic 3: Simplifying the “Use Existing Content” Workflow in Courses (formerly the “Library Block”)

...

• Authors can opt to connect one or multiple Libraries to a Course. Two pathways to connect a Library to a Course:

  • At the course level (ie, somewhere at the Course Outline page, etc)

  • At the unit level, particularly the first time an author wants to “use existing content”

    • [Note: This assumes that Libraries are a feature enabled in the “out of the box” Open edX experience and don’t require to be enabled via Advanced Settings.]

• Once a Library is connected, Authors do not have to choose which Library(ies) to pull from, every time they want to use existing content.

• Authors can disconnect Libraries at any time.

• Authors can add new Libraries at any time.

• What metadata needs to be displayed in the course view of Library content?

  • [Support of thumbnails in course view of Library content]

  • At a glance info?

Requirements for reuse:

• Authors can pull any particular component from their connected Libraries into their Course

• Authors can use/leverage the same search and discovery functionality (Epic 1) that exists within the Libraries in order to find the content they wish to use.

• If multiple Libraries are connected to the course, the default search experience encompasses all connected Libraries, with an option to refine a search to a single particular Library.

• When components are pulled into a course, if tags had been added to the Component in the Library, those tags carry over with the Component and display in the course

  • Authors can add new tags to the Course version of the component, but they cannot delete tags that were added in the Library.

• Requirement for content edits in the course - mirrors current behavior

• Updates do apply/notifications

Requirements for randomized reuse:

• Authors have four options for creating pools of content to randomize:

  • Authors can choose a Collection that already exists from a Library. All of the content in that Collection will become part of the randomized pool.

  • Authors can query tags to choose which components they want to become part of a randomized pool/collection:

    • Give me all the problems with Tag: Accounting

    • Give me all problems with Tag: Accounting and Tag:Easy

    • Give me all the problems with one of the following tags: Tag: Accounting, Tag:Section1

  • Authors can query tags with refinement

  • Authors can select a Collection and then search and refine within the Collection

Requirements for updating content:

• If content is updated in a Library, authors receive a notification in the Courses where that content is being used, with an option to view the updates and either to accept or reject them.

• Authors can pro-actively query Libraries for updated content, view the updates, and opt to update any existing content in their courses.

  • Option to pull all updates from a Library.

  • Option to update individual components.

Do updates from a library override any changes that had been previously made locally? Could see the edit history?

Define requirements for whether library content has any settings/configurations/policy attached to it at the library level, or just the course level?