diff --git a/source/_images/release_notes/olive/close_post.gif b/source/_images/release_notes/olive/close_post.gif new file mode 100644 index 00000000..1a5eea66 Binary files /dev/null and b/source/_images/release_notes/olive/close_post.gif differ diff --git a/source/_images/release_notes/olive/discussA1.png b/source/_images/release_notes/olive/discussA1.png new file mode 100644 index 00000000..de73f770 Binary files /dev/null and b/source/_images/release_notes/olive/discussA1.png differ diff --git a/source/_images/release_notes/olive/discussA2.png b/source/_images/release_notes/olive/discussA2.png new file mode 100644 index 00000000..1d60b690 Binary files /dev/null and b/source/_images/release_notes/olive/discussA2.png differ diff --git a/source/_images/release_notes/olive/discussA3.png b/source/_images/release_notes/olive/discussA3.png new file mode 100644 index 00000000..78d0d7c7 Binary files /dev/null and b/source/_images/release_notes/olive/discussA3.png differ diff --git a/source/_images/release_notes/olive/discussA4.png b/source/_images/release_notes/olive/discussA4.png new file mode 100644 index 00000000..95ae35d9 Binary files /dev/null and b/source/_images/release_notes/olive/discussA4.png differ diff --git a/source/_images/release_notes/olive/discussB1.png b/source/_images/release_notes/olive/discussB1.png new file mode 100644 index 00000000..0dbfd958 Binary files /dev/null and b/source/_images/release_notes/olive/discussB1.png differ diff --git a/source/_images/release_notes/olive/discussB2.png b/source/_images/release_notes/olive/discussB2.png new file mode 100644 index 00000000..04d2e54d Binary files /dev/null and b/source/_images/release_notes/olive/discussB2.png differ diff --git a/source/_images/release_notes/olive/discussB3.png b/source/_images/release_notes/olive/discussB3.png new file mode 100644 index 00000000..c2eba209 Binary files /dev/null and b/source/_images/release_notes/olive/discussB3.png differ diff --git a/source/_images/release_notes/olive/discussB4.png b/source/_images/release_notes/olive/discussB4.png new file mode 100644 index 00000000..bbf465a2 Binary files /dev/null and b/source/_images/release_notes/olive/discussB4.png differ diff --git a/source/_images/release_notes/olive/discussB5.png b/source/_images/release_notes/olive/discussB5.png new file mode 100644 index 00000000..7b7368e4 Binary files /dev/null and b/source/_images/release_notes/olive/discussB5.png differ diff --git a/source/_images/release_notes/olive/discussB6.png b/source/_images/release_notes/olive/discussB6.png new file mode 100644 index 00000000..9c37e5a1 Binary files /dev/null and b/source/_images/release_notes/olive/discussB6.png differ diff --git a/source/_images/release_notes/olive/discussB7.png b/source/_images/release_notes/olive/discussB7.png new file mode 100644 index 00000000..863da4ee Binary files /dev/null and b/source/_images/release_notes/olive/discussB7.png differ diff --git a/source/_images/release_notes/olive/discussB8.png b/source/_images/release_notes/olive/discussB8.png new file mode 100644 index 00000000..7bc7ef9f Binary files /dev/null and b/source/_images/release_notes/olive/discussB8.png differ diff --git a/source/_images/release_notes/olive/discussC1.png b/source/_images/release_notes/olive/discussC1.png new file mode 100644 index 00000000..863da4ee Binary files /dev/null and b/source/_images/release_notes/olive/discussC1.png differ diff --git a/source/_images/release_notes/olive/discussC2.png b/source/_images/release_notes/olive/discussC2.png new file mode 100644 index 00000000..c3b7508e Binary files /dev/null and b/source/_images/release_notes/olive/discussC2.png differ diff --git a/source/_images/release_notes/olive/discussC3.png b/source/_images/release_notes/olive/discussC3.png new file mode 100644 index 00000000..40f88d3f Binary files /dev/null and b/source/_images/release_notes/olive/discussC3.png differ diff --git a/source/_images/release_notes/olive/discussC4.png b/source/_images/release_notes/olive/discussC4.png new file mode 100644 index 00000000..d4254e05 Binary files /dev/null and b/source/_images/release_notes/olive/discussC4.png differ diff --git a/source/_images/release_notes/olive/discussC5.png b/source/_images/release_notes/olive/discussC5.png new file mode 100644 index 00000000..989689a5 Binary files /dev/null and b/source/_images/release_notes/olive/discussC5.png differ diff --git a/source/_images/release_notes/olive/discussC6.png b/source/_images/release_notes/olive/discussC6.png new file mode 100644 index 00000000..afd219e4 Binary files /dev/null and b/source/_images/release_notes/olive/discussC6.png differ diff --git a/source/_images/release_notes/olive/discussC7.png b/source/_images/release_notes/olive/discussC7.png new file mode 100644 index 00000000..5111877d Binary files /dev/null and b/source/_images/release_notes/olive/discussC7.png differ diff --git a/source/_images/release_notes/olive/edit_post_reasons.gif b/source/_images/release_notes/olive/edit_post_reasons.gif new file mode 100644 index 00000000..a3ca09dd Binary files /dev/null and b/source/_images/release_notes/olive/edit_post_reasons.gif differ diff --git a/source/_images/release_notes/olive/editor1.png b/source/_images/release_notes/olive/editor1.png new file mode 100644 index 00000000..c1d5ec0e Binary files /dev/null and b/source/_images/release_notes/olive/editor1.png differ diff --git a/source/_images/release_notes/olive/editor2.png b/source/_images/release_notes/olive/editor2.png new file mode 100644 index 00000000..9c52661a Binary files /dev/null and b/source/_images/release_notes/olive/editor2.png differ diff --git a/source/_images/release_notes/olive/editor3.png b/source/_images/release_notes/olive/editor3.png new file mode 100644 index 00000000..f268eeea Binary files /dev/null and b/source/_images/release_notes/olive/editor3.png differ diff --git a/source/_images/release_notes/olive/editor4.png b/source/_images/release_notes/olive/editor4.png new file mode 100644 index 00000000..c9a95a31 Binary files /dev/null and b/source/_images/release_notes/olive/editor4.png differ diff --git a/source/_images/release_notes/olive/editor5.png b/source/_images/release_notes/olive/editor5.png new file mode 100644 index 00000000..0f5b4cde Binary files /dev/null and b/source/_images/release_notes/olive/editor5.png differ diff --git a/source/_images/release_notes/olive/editor6.png b/source/_images/release_notes/olive/editor6.png new file mode 100644 index 00000000..3618b1a6 Binary files /dev/null and b/source/_images/release_notes/olive/editor6.png differ diff --git a/source/_images/release_notes/olive/editor7.png b/source/_images/release_notes/olive/editor7.png new file mode 100644 index 00000000..9231a416 Binary files /dev/null and b/source/_images/release_notes/olive/editor7.png differ diff --git a/source/_images/release_notes/olive/editor8.png b/source/_images/release_notes/olive/editor8.png new file mode 100644 index 00000000..d8e44c40 Binary files /dev/null and b/source/_images/release_notes/olive/editor8.png differ diff --git a/source/_images/release_notes/olive/enable_discussion_studio.gif b/source/_images/release_notes/olive/enable_discussion_studio.gif new file mode 100644 index 00000000..a7eac177 Binary files /dev/null and b/source/_images/release_notes/olive/enable_discussion_studio.gif differ diff --git a/source/_images/release_notes/olive/new_filter_ui.gif b/source/_images/release_notes/olive/new_filter_ui.gif new file mode 100644 index 00000000..4a831a05 Binary files /dev/null and b/source/_images/release_notes/olive/new_filter_ui.gif differ diff --git a/source/_images/release_notes/olive/roundup1.png b/source/_images/release_notes/olive/roundup1.png new file mode 100644 index 00000000..dd11aa06 Binary files /dev/null and b/source/_images/release_notes/olive/roundup1.png differ diff --git a/source/_images/release_notes/olive/roundup2.png b/source/_images/release_notes/olive/roundup2.png new file mode 100644 index 00000000..771e43c2 Binary files /dev/null and b/source/_images/release_notes/olive/roundup2.png differ diff --git a/source/_images/release_notes/olive/roundup3.png b/source/_images/release_notes/olive/roundup3.png new file mode 100644 index 00000000..f3dbe9fe Binary files /dev/null and b/source/_images/release_notes/olive/roundup3.png differ diff --git a/source/_images/release_notes/olive/roundup4.png b/source/_images/release_notes/olive/roundup4.png new file mode 100644 index 00000000..863da4ee Binary files /dev/null and b/source/_images/release_notes/olive/roundup4.png differ diff --git a/source/_images/release_notes/olive/roundup5.png b/source/_images/release_notes/olive/roundup5.png new file mode 100644 index 00000000..fc1dd7f3 Binary files /dev/null and b/source/_images/release_notes/olive/roundup5.png differ diff --git a/source/_images/release_notes/olive/roundup6.png b/source/_images/release_notes/olive/roundup6.png new file mode 100644 index 00000000..fe44ff0d Binary files /dev/null and b/source/_images/release_notes/olive/roundup6.png differ diff --git a/source/community/release_notes/old_releases.rst b/source/community/release_notes/old_releases.rst index fd9da5b7..f58e61fe 100644 --- a/source/community/release_notes/old_releases.rst +++ b/source/community/release_notes/old_releases.rst @@ -13,7 +13,7 @@ fixes and features. These older releases will not receive any of those. quince-landing palm-landing - olive + olive-landing nutmeg maple lilac diff --git a/source/community/release_notes/olive-landing.rst b/source/community/release_notes/olive-landing.rst new file mode 100644 index 00000000..ab5094a9 --- /dev/null +++ b/source/community/release_notes/olive-landing.rst @@ -0,0 +1,14 @@ +Open edX Olive Release +###################### + +These are the release notes for the Palm release, the 16th community release +of the Open edX Platform, released in June 2023. You can also review details +about :doc:`index` or learn more about the `Open edX Platform`_. + +.. toctree:: + :maxdepth: 2 + + olive/feature_release_notes + olive + +.. _Open edX Platform: https://openedx.org \ No newline at end of file diff --git a/source/community/release_notes/olive/feature_release_notes.rst b/source/community/release_notes/olive/feature_release_notes.rst new file mode 100644 index 00000000..5be3d565 --- /dev/null +++ b/source/community/release_notes/olive/feature_release_notes.rst @@ -0,0 +1,19 @@ +Open edX Olive Release - Feature-Based Notes +############################################ + +.. toctree:: + :maxdepth: 1 + + olive_studio_editor + olive_discussions + olive_discussions_mods + olive_3rd_party_discussions + +.. toctree:: + :maxdepth: 2 + + feature_roundup + +Information for site operators and developers, including information on how to +enable and/or configure new features that require additional work, can be found +in the :doc:`../palm`. \ No newline at end of file diff --git a/source/community/release_notes/olive/feature_roundup.rst b/source/community/release_notes/olive/feature_roundup.rst new file mode 100644 index 00000000..6a15d382 --- /dev/null +++ b/source/community/release_notes/olive/feature_roundup.rst @@ -0,0 +1,141 @@ +Olive Feature Roundup +##################### + +The Olive release contains many features, enhancements, and improvements. Some +are the subject of their own blog posts: :doc:`olive_discussions` and :doc:`olive_studio_editor`. +In this post we'll run through a number of other interesting +additions to the platform, with brief descriptions of what they are. + +.. contents:: + :local: + :depth: 1 + +Resets for Randomized Content Blocks +************************************ + +Randomized content blocks now have a “Reset” option, allowing learners to +prepare themselves for exams by answering a series of questions at random from a +predetermined problem bank (similar to flashcards). `This video demo of the +feature `_ shows +the learner experience of being able to answer some questions within the Open +edX LMS and then clicking a “Reset” option to get a new set of unanswered +questions. + + .. image:: /_images/release_notes/olive/roundup1.png + + +To enable this feature, create a Randomized Content Block in Studio and set the +:guilabel:`Show Reset Button`` option to True. + + .. image:: /_images/release_notes/olive/roundup2.png + + +Note: before you can add randomized content blocks to your course, you must add +a Content Library in Studio. Once you've done that, you can add the randomized +content block by clicking the “Library Content” button when adding a new +Component to a Unit. See the next section for instructions on how to get a test +library. + +Open edX Test Course & Test Library +*********************************** + +The Open edX project now provides a `testing course & testing library +`_ with the aim +of exposing as many Open edX Studio & courseware features as possible. The test +course provides example usages of various block types and by enabling various +features through Advanced Settings, and also exposes usage of the test Content +Library. You are free to use these in your installation; it is useful both to +see how a problem type behaves in the LMS as well as how to set it up in Studio. + + .. image:: /_images/release_notes/olive/roundup3.png + + +Install the course or library by creating a new, blank course or library in +Studio. Then, from the Tools menu, select :guilabel:`Import`. Upload the correct file +(``test-course.tar.gz`` or ``test-problem-bank.tar.gz``), and you will be all set. + +This course is new as of the Maple (June 2022) release, and is tested to work on +both Maple and Nutmeg; it's a bit sparse at the moment, but will be continually +updated over time. Currently, the test course contains at least one usage of all +advanced block types that come pre-installed in the Open edX release. Some of +the block usages aren't yet configured; for example, the LTI Consumer block +usage exists with instructions on how to use it, but it isn't actually set up to +consume an LTI tool yet. + +We are looking for contributions to make this course better! If you're +interested in contributing, here are some things we're looking for: + +* Actual tool launches for various configurations of lti and lti_consumer blocks. +* Use of content groups for units and sequences. Currently, content groups are only tested at the component (sub-unit) level. +* Use of custom Python in Advanced LONCAPA problems. +* Examples usages of start/end dates, beta-released content, etc. +* Handouts, static tabs, and other advanced uses of the Course Home. + +If you want to help out but don't know where to start, visit us on the +`Discussion Forums `_. Instructions for contributing +are also available `on GitHub `_. + +Pages and Resources View +************************ + +Olive contains a new micro front-end (MFE) called course authoring, which +enables an overhaul of the Pages and Resources view. This is a page within your +course's configuration in Studio that allows you to easily turn features on and +off; applications and tools that previously required fiddling with advanced +course settings can now be set up in a few clicks using the Course Authoring +MFE. + + .. image:: /_images/release_notes/olive/roundup4.png + + +Clicking the gear icon on “Progress”, “Wiki”, and “Calculator” creates a pop-up +that allows you to quickly enable or disable the feature for the course. We'll +cover the various options available when choosing the Discussion option in a +future post. + +Authentication Micro-frontend (MFE) +*********************************** + +A new MFE has been added in this release, known as the `Authentication (or +“Authn”) MFE `_. This provides a +streamlined registration, sign in, and Forgot Password experience. During the +registration process, a set of available usernames are suggested, based on the +full name entered. + + .. image:: /_images/release_notes/olive/roundup5.png + +If an entered username already exists, the user is notified and given some similar, available suggestions. + + .. image:: /_images/release_notes/olive/roundup6.png + + +Some brief operator notes: you can set the `LOGO_URL MFE setting +`_ +(which you should be able to do `via dynamic configuration +`_ +in Olive) to add your logo to this page. There are also instructions for +installing a custom brand package in an MFE in the `tutor-mfe README +`_. If you'd like to +revert to the legacy experience, running ``tutor config save --set +MFE_AUTHN_MFE_APP=null`` would be the simplest possible way, as instructed in +the `tutor-mfe README +`_. + +Other Small/Operational Changes +******************************* + +* The `Molecular Structure Problem type + `_ was removed. +* The Learning Micro front-end is now required and the legacy learner view has + been deprecated. This means that if your instance hasn't been using the + Learning MFE, it will now, and you may notice some slight visual changes. +* Grades are now persistent, meaning that they are stored in MySQL database + tables for fast access and improved performance anywhere grades information + exists. This has been optional since Hawthorn but is now required. For + technical information about the upgrade, `visit this wiki page + `_. +* Android app support is currently limited to `Release 3.0.2 + `_ + of the ``edx-android-app`` codebase. The only noticeable impact here is that + there may be new features in the iOS app that are not in the older version of + the Android release. diff --git a/source/community/release_notes/olive/olive_3rd_party_discussions.rst b/source/community/release_notes/olive/olive_3rd_party_discussions.rst new file mode 100644 index 00000000..75622a3b --- /dev/null +++ b/source/community/release_notes/olive/olive_3rd_party_discussions.rst @@ -0,0 +1,152 @@ +Configuring 3rd Party Discussion Experiences (Olive) +#################################################### + +The Olive release includes the ability to configure a 3rd party discussion +provider for your course's discussion experience. This configuration is done +within Studio. Read on for more details. + +.. contents:: + :local: + :depth: 2 + +Setup Discussions Prior to Course Start +*************************************** + +The Olive release includes the ability to configure a 3rd party discussion +provider for your course's discussion experience. This must be done prior to a +course's start date. To do this, first navigate to the Pages and Resources view: + + .. image:: /_images/release_notes/olive/discussC1.png + + +Clicking on the “Discussion” gear icon brings you to a landing page where you +can pick from various discussion provider options for your course: + + .. image:: /_images/release_notes/olive/discussC2.png + + +The options include descriptions, and a checklist below the options compare the +benefits of the various types of providers. Note that only the “edX” option is +included with the Olive release. Configuring one of the other providers +(Yellowdig, InScribe, Piazza, or Ed Discussion) requires you to have a +subscription at that site. These external providers may charge for their +services. + +Enabling a Third-Party Discussions Provider +******************************************* + +Your instance administrator will help you configure the new discussions provider +for your course. Note that you'll need your course to allow PII sharing with the +discussions provider. You should ensure you understand the implications of this, +which may include sending learner usernames, email addresses, and/or full names +to the third party provider, and may not be allowed in your jurisdiction. + +First, reach out to your chosen provider and get a course set up. You will need +them to send you the following LTI launch info: Consumer Key, Consumer Secret, +and Launch URL. Once you have that, your instance administrator will take the +following steps: + +#. To turn on PII sharing, your instance administrator will visit the admin page + for PII sharing at + ``[your-site-url]/admin/lti_consumer/courseallowpiisharinginltiflag`` and + enable the option using your course's course key. + +#. Once that is done, the instance administrator will be able to set up the LTI + integration by visiting the course's Pages & Resources view in Studio, + clicking on the preferred discussion provider, and filling in the LTI launch + info: + + .. image:: /_images/release_notes/olive/discussC3.png + + + +We'll now take a short look at the four available discussion providers and let +you know how to get started with each of them. + +Ed Discussion +============= + +`Ed Discussion `_ helps scale class communication in an +intuitive interface to facilitate Q&A and quality discussion, provide course +information and more. Moderation tools are robust, and instructors can access an +analytics page which shows trends in participation, views, answers, and top +contributors across a variety of metrics. Functionality includes automation, +advanced LaTeX, image annotation, live interpreters to help learners write and +execute code directly, and much more for STEM, CS, business and many other +disciplines. + +Complementing Ed Discussion are `Ed Lessons `_ and +`Ed Workspaces `_ for interactive content to +learn and practice skills like programming, bash scripts, HTML pages, +collaborative JuPyter notebooks, and much more. + + .. image:: /_images/release_notes/olive/discussC4.png + +For more information or to get started with Ed Discussion visit `edstem.org +`_ or contact team@edstem.org. + +*Note: the above screenshot was provided by edX. The tCRIL team has been unable +to confirm that the iframe view of Ed Discussions works in Olive; for us, Ed +Discussions opened full screen rather than embedded in the LMS.* + +Yellowdig +========= + +`Yellowdig `_ is a community-focused platform aiming +to turn your course into an active learning community through its +research-driven, hyper-interactive, Yellowdig Engage platform. This platform was +built upon principles of Agency, Mastery, and Connectedness. Yellowdig is unique +in providing a graded discussions experience which is cumulative over the span +of your course, encouraging repeated and active participation in the discussions +forums. + + .. image:: /_images/release_notes/olive/discussC5.png + + + +To learn more about Yellowdig, check out their `Resources page +`_, take their `introductory instructor and +design courses `_, or email +learnmore@yellowdig.com. + +Note: In the Olive release, the grade passback functionality is not implemented +in the Discussions MFE integration. To enable grades from Yellowdig in your +platform, we recommend that you `manually export grades from Yellowdig +`_ +and input the scores directly into your course. + +InScribe +======== + +InScribe is a learning support tool built on a community model. With InScribe, +learners and moderators can create conversations that can be collaboratively +answered and endorsed by moderators.Conversations are organized into topics, +which make it easier to navigate content. You can also copy your term into a new +course, to preserve useful content for future learners. + + .. image:: /_images/release_notes/olive/discussC6.png + + + +To get a peek into how a community can be used as a knowledge repository as well +as a place to get accurate information, ask questions, and connect with peers, +visit `InScribe's Get to Know Us Page +`_ +and their `tips for a thriving community +`_. +To get started with InScribe, reach out to hello@inscribeapp.com. + +Piazza +====== + +`Piazza `_ is an engaging question and answer tool that +focuses on features such as wiki-style collaborative answers to questions, +support for mathematical-based courses in LaTeX, real-time updating, and +effective moderation tools such as instructor-endorsed answers. Instructors can +view engagement reports that give insight into individual participation levels +and allow you to pinpoint when your class is asking the highest volume of +questions. + + .. image:: /_images/release_notes/olive/discussC7.png + +To get started with Piazza, reach out to team@piazza.com. diff --git a/source/community/release_notes/olive/olive_discussions.rst b/source/community/release_notes/olive/olive_discussions.rst new file mode 100644 index 00000000..9cae6b14 --- /dev/null +++ b/source/community/release_notes/olive/olive_discussions.rst @@ -0,0 +1,95 @@ +New and Improved Discussions Forum (Olive) +########################################## + +The new Community Release, Olive, contains many long-awaited updates to the +Discussions Forums experience, for learners, course teams and forum moderators. + +.. contents:: + :local: + :depth: 1 + +A freshly designed UI +********************* + + .. image:: /_images/release_notes/olive/discussA1.png + +In the above screenshot, you can see how the author of a “Question” type post +can mark a response as an “Answer” to the question that was asked. Additionally, +a new tabular layout (top left) makes it easier for both learners and moderators +to see, organize and track forum activity. + +In the new layout, learners and course teams have access to: + +#. The *My Posts* tab shows posts authored by the current user. +#. The *All Posts* tab shows all posts in the course. +#. The *Topics* tab shows hierarchy of discussion topics (categories and + subcategories). +#. The *Learners* tab shows per-user statistics for the course forum, allowing + you to sort by top poster or recent posters, and to drill down into forum + activity by individual learner. + +The new UI also enables improved functionality for sorting and filtering posts. +The new layout makes it easier for users to filter for followed posts, recent +activity and more. New filters for post types (Discussions and Questions) have +also been added. + + .. image:: /_images/release_notes/olive/new_filter_ui.gif + +Upgraded search experience +************************** + + .. image:: /_images/release_notes/olive/discussA2.png + + +A single search bar can now be used for keyword searches across content, topics +and learners, including searches for partial usernames. Keyword searches are +refined by tab. For example, typing the keyword “Introduction” in the search +bar, with the “My Posts” tab selected, will limit results to only posts I’ve +written. You can instead choose to search “All posts”, search topic titles under +“Topics”, or search for a specific learner under “Learners”. + +Interactive post summaries +************************** + +New interactive post summaries in the left sidebar streamline interaction +opportunities for learners and make it easier to track post activity: + + .. image:: /_images/release_notes/olive/discussA3.png + + +Legend: + +#. An icon indicating if a post was submitted as a question. +#. The username of the post author is now visible, along with specific colors + and icons to indicate user roles such as “Staff”. +#. Number of likes, with the option to like or unlike directly. +#. A clickable star icon to follow or unfollow a post. +#. Number of responses. +#. An answered icon to indicate if an open question was answered. +#. Flags to identify reported content in the post or in its comments. + + +Inline Discussions +****************** + +In-context discussions appear, as before, below course content. + + .. image:: /_images/release_notes/olive/discussA4.png + + + +In the next release, Palm, look forward to a new interface that will allow you +to display the in-context discussions within a sidebar on the right side of the +course content. + +And more! +********* + +:doc:`olive_discussions_mods` takes a look at some of the new features for the forum +moderation team, as well as improvements to course authoring. Site operators can +find information about how to configure the new Discussions feature in the Olive +release notes. + +*Thank you to `Kshitij Sobti +`_ +and the team at OpenCraft for the gif shown in this post.* diff --git a/source/community/release_notes/olive/olive_discussions_mods.rst b/source/community/release_notes/olive/olive_discussions_mods.rst new file mode 100644 index 00000000..9b17d71d --- /dev/null +++ b/source/community/release_notes/olive/olive_discussions_mods.rst @@ -0,0 +1,147 @@ +Moderation & Authoring Tools for the New Discussions Feature (Olive) +#################################################################### + +The new Community Release, Olive, contains many long-awaited updates to the +Discussions Forums experience, for learners, course teams and forum moderators. +See :doc:`olive_discussions` for a look at the new UI of the forums. This post dives +into new features and substantial improvements made for moderators & course +authors. The following video gives a short overview, and the post dives into +more detail. + +.. youtube:: l1g-oRzSN3w + +.. contents:: + :local: + :depth: 2 + +New features for Forum Moderators +********************************* + +The following features streamline Moderator workflows and standardize +touchpoints between Moderators and Learners. In a post's three dot menu, +moderators and staff will see options to edit, pin, close, or delete any forums +post (post authors may edit or delete their own posts as well). + +Reasons for closing a post +========================== + +Moderators may now specify reasons for their decision to close a post from a +pre-selected list. + + .. image:: /_images/release_notes/olive/close_post.gif + + +Reasons for editing a post +========================== + +Moderators may now specify the reasons for editing a post author's content. + + .. image:: /_images/release_notes/olive/edit_post_reasons.gif + + +For both editing and closing a post, the reason supplied can be seen by all +other staff members as well as the post's author in a banner at the top of the +post. + +Endorsing a response +==================== + +Moderators may endorse a response to a question, which pushes it to the top of +the list of responses. This is done using the three-dot context menu on the +response itself. + + .. image:: /_images/release_notes/olive/discussB1.png + + +Improved filtering and sorting of post stats +============================================ + +Moderators now have access to the following stats from the new Learners' Tab: + +#. Sort menus for learners by “Most Activity” and “Recent Activity” + + .. image:: /_images/release_notes/olive/discussB2.png + + +#. Count of total content (posts and responses) authored by learner + + .. image:: /_images/release_notes/olive/discussB3.png + + +#. List of threads interacted with by individual learner + + .. image:: /_images/release_notes/olive/discussB4.png + + + +#. Red label for reported content in a learner's history + + .. image:: /_images/release_notes/olive/discussB5.png + + +#. Additional filters for searching the post history of individual learners, such as filtering by “Question” or “Discussion” post types + + .. image:: /_images/release_notes/olive/discussB6.png + + + +Authoring Experience +******************** + +Adding a discussion to a unit +============================= + +When authoring course content, you no longer need to create a discussion block +and manually set a category and subcategory. With the new mechanism, you simply +tick a checkbox for a Unit, and it will automatically be associated with a topic +with the same name as the unit, and the discussions UI will show up for that +Unit. By default, all Units will automatically be discussable unless they are in +graded or exam subsections. + +For units in graded subsections, discussions can be enabled by clicking the Gear +icon from the Studio outline page: + + .. image:: /_images/release_notes/olive/enable_discussion_studio.gif + + +This new configuration mechanism does mean certain scenarios are no longer +supported: + +* Previously, it was possible to have multiple discussion blocks in a single + Unit, thus allowing multiple topics for a single unit. Now there can only be + one. +* Previously, you had to specify a separate category and subcategory for each + topic, and these did not need to match the course hierarchy. Now, the + categories are defined automatically with no override. +* Additionally, discussion units in exams are no longer possible. +* There was an undocumented, and somewhat broken, mechanism for having + discussion topic hierarchies of arbitrary depths. This is no longer possible. + +Configuring discussions for your course +======================================= + +The new discussions experience is turned on for every new course in your +instance. To configure it, visit the Content > Pages & Resources menu, which has +a new and improved look: + + .. image:: /_images/release_notes/olive/discussB7.png + + + +Clicking on the gear icon for “Discussions” will lead you to a menu where you +can choose the “edX” discussion experience. Choosing this option will bring you +to a page where you can set up discussion cohorts, discussion blackout dates, +and more. + + .. image:: /_images/release_notes/olive/discussB8.png + + + +You will notice there are also choices for 3rd-party discussion providers. These +solutions are not built into the Open edX platform, may cost money, and require +effort from site administrators to enable. See +:doc:`olive_3rd_party_discussions` for more detail. + +*Thank you to `Kshitij Sobti +`_ +and the team at OpenCraft for the gifs shown in this post.* diff --git a/source/community/release_notes/olive/olive_studio_editor.rst b/source/community/release_notes/olive/olive_studio_editor.rst new file mode 100644 index 00000000..430e26e7 --- /dev/null +++ b/source/community/release_notes/olive/olive_studio_editor.rst @@ -0,0 +1,98 @@ +Improved Studio Editing in Olive +################################ + +With the recent release of Olive, the newest Open edX named release, comes some +significant improvements to the text editing experience within what was formerly +known as the “HTML Component”. With this new feature, it's easier to add things +to your text, such as: + +* images from your image gallery +* special characters and symbols +* emoticons + +Editing is also more streamlined, with new enhancements such as: + +* editing in full-screen mode +* undo / redo actions +* table authoring without going into HTML mode + +Read on for a rundown of everything you need to know about the Text Component. + +.. contents:: + :local: + :depth: 1 + + +Updated Editor Overview +*********************** + + .. image:: /_images/release_notes/olive/editor1.png + +The visual above shows the updated Text component editor, which opens up in +full-screen mode, allowing you to seamlessly build blocks with large amounts of +content. It has a new toolbar that starts with undo (backwards arrow) and redo +(forward arrow) actions, existing formatting options, text layout tools, and +list and indentation controls. Additional details for the remaining tools are +described below. + +Adding Images +************* + +We have made it easier to reference existing files & uploads from your course in +text components as shown in the visual below. You can search and sort all images +as well as upload new images to your course as you are authoring a specific text +component. + + .. image:: /_images/release_notes/olive/editor2.png + + +Special Characters +****************** + +We have also introduced a way to include special characters +into your text content, including mathematical and symbolic elements. + + .. image:: /_images/release_notes/olive/editor3.png + + +Emoticon Support +**************** + +You can now also easily add emoticons into your text content, a small but +visually obvious way to break up long stretches of text content. You can see the +emoticon library tool referenced below. + + .. image:: /_images/release_notes/olive/editor4.png + + +Visual Table Editor +******************* + +Another category of new tools we have added includes the addition of tables +without needing to jump to the HTML editor. The table toolbar icon lets you drop +in a table component: + + .. image:: /_images/release_notes/olive/editor5.png + + +Selecting a given cell of the table within the editor view lets you create, +remove, or adjust rows and columns: + + .. image:: /_images/release_notes/olive/editor6.png + + +Dragging one of the table's corners allows you to resize it: + + .. image:: /_images/release_notes/olive/editor7.png + +The remaining two buttons on the toolbar are *Clear Formatting* and *HTML Edit*. + + .. image:: /_images/release_notes/olive/editor8.png + + +Clear Formatting allows you to highlight any amount of formatted text and revert +its formatting. HTML Edit allows you to view the raw HTML of the Text Component; +you may adjust the HTML directly, if you wish. + +We hope this improved editor will speed up the content authoring process and +enable you to create richer experiences for your learners!