Add Facilitator Notes area to Lessons

[kathrynwp]

Summary

Let's add a new section to individual lessons in Sensei, to house "Facilitator Notes"

Purpose

The purpose of this section is to provide additional material associated with a lesson, geared to facilitators who would like to use the material to teach others. For example, content creators may include a list of prerequisites, objectives, or learning outcomes.

To keep in mind

• This is envisioned as a tab that allows visitors to toggle between the lesson content and the Facilitator Notes.
• The Facilitator Notes content should be compatible with TranslatePress.
• The link to the Facilitator Notes section should not appear if there's no content in the Facilitator Notes area.
• This section will be a freeform text area, blank by default.
• The data should be pulled out of a custom field within Sensei, connected to each lesson.

Populating Facilitator Notes

I've separated this issue from the previous one in #2392, since we don't want to immediately run an automated content migration from Lesson Plans to Facilitator Notes, but instead undertake a more curated, manual survey of what content is currently living in Lesson Plans and what is worthwhile to move into which lesson(s), if any.

Content creators might also undertake to add certain Facilitator Notes (such as prerequisites, learning outcomes, etc.) to the Learning Pathway courses, in lieu of trying to match up older lesson plans with newer lessons.

Where to add the link

Perhaps it could go below or above "Suggestions" in the left sidebar?

cc @westnz @jonathanbossenger @Piyopiyo-Kitsune

[westnz]

This is a tough one since having the Facilitator Notes in the course's left sidebar might be confusing. Could we explore displaying it directly on the lesson page instead? If we stick with the sidebar option, I suggest placing it below 'Suggestions,' but we'd need to add another Separator block.

[jonathanbossenger]

The location of the facilitator notes link should also take into account what happens when the link is clicked.

Wherever we put the link, if a new learner clicks on it and sees the content, that will cause some confusion. Perhaps placing it somewhere that's not front and center to the learner but can be documented for facilitators?

The first place that comes to mind is the WordPress admin bar.

Then, when the link is clicked, the notes slide on from the left of the lesson, as a sticky overlay.

This does mean it might overlay the lesson content a little on smaller resolutions, but as long as the facilitator can still scroll to see the content, I think that's ok.

[kathrynwp]

Interesting idea to put it in the admin bar, but I'm concerned that it might be easily overlooked there. Since the Facilitator Notes aren't technically a WordPress/Sensei administrative action, but something visible to all (i.e. not related to editing or otherwise manipulating the lesson on the admin side.) I'm also wondering if it might not make sense to put them up in the admin area.

Looping in @WordPress/meta-design to see what ideas you might have.

[jasmussen]

The adminbar should never be visible to someone who isn't logged in. The fact that it is, at present, is a bug that should hopefully be fixed somewhat soon, as part of WordPress/wporg-mu-plugins#647.

So if facilitator notes are to be visible to someone who isn't logged in, the admin-bar is a non-starter.

On the flipside, if facilitator notes should be visible only to someone who's logged in, the admin-bar may be an acceptable place.

A link at the bottom of the sidebar could be okay with me. We can even add help-text below the link, which describes in more depth what those notes are about, and who they are for.

[kathrynwp]

I just realized that one issue with putting it in the sidebar is that the sidebar is only visible on lessons that are contained inside published courses. Right now, we publish lessons even when the full course hasn't yet gone live (been published). For example, see this lesson in the yet-to-be-published Advanced WP User course:

https://learn.wordpress.org/lesson/why-would-a-wordpress-user-need-to-run-a-local-site/

There's no sidebar because right now it's acting as a "standalone" lesson, without being part of a published course. Down the road, once the Advanced WordPress User course is published, the sidebar will be present.

So if facilitator notes are to be visible to someone who isn't logged in, the admin-bar is a non-starter.

I think the facilitator notes should probably be available to anyone who is previewing a lesson, even if they haven't registered to take the course. Previews are available even to logged-out users.

@jasmussen Given the above factors, can you think of anywhere else to put the link/tab? Maybe somewhere in this sticky bar, circled here: