1818121 - SUMO update to reflect: About Picture-in-Picture article

Status: NEW

(support.mozilla.org :: Knowledge Base Content, task)

Description

[Ania]

Attachment: PiP windows

Product

Choose one below and delete others
Firefox

Select the type of request

Choose one below and delete others
Major update to existing feature/functionality

Is the content embargoed (yes or no)?

No

What current go-to-market plans, timelines, or milestones exist?

New Picture-in-Picture will be released in Nightly 112 and stable channel 113 unless we discover major defects we cannot fix on time.

Please include any related JIRA/Github/Bugzilla tickets, documentation, demos or practical use cases.

Spec
Figma
Bugzilla Meta Bug

Please add instructions for testing or links to any design assets or visuals.

1. Install and run the latest Nightly build.
2. Open about:config, look for media.videocontrols.picture-in-picture.improved-video-controls.enabled pref and flip it to true.
3. Open Youtube or any other video website, and launch PiP.

Does the content need to be localized in any languages outside of our priority locales (yes or no)?

Note: Minimum of 10 days required for translation requests
Yes

Does the content require legal review (yes or no)?

No

Structural updates to the article

Perhaps we can restructure the article, and present information in this order:
Intro
Includes a mention that PiP lets you play/pause, rewind, go full screen, and follow along with subtitles or closed captions. I attached how the toggle looks like currently.
- Screenshot of pip
Watching videos in Picture-in-Picture
- Toggle
The toggle has changed text, and I wonder if it might be valuable to include a gif here instead of screenshots?
- Context menu (I added a fresh screenshot for this section)
- Subtitles
- I think it might be valuable to add a screenshot here (attached)
- Keyboard shortcuts
- Let’s please add «Double-click: Full-screen mode» to this list
Disabling Picture-in-Picture

Sections to remove

YouTube video - the video is handy, but it displays (and we will soon update the toggle UI making it very much obsolete). How do you feel about removing it and replacing it with a screenshot?
Player window - I feel like mentioning controls in the intro is enough, and this paragraph does not help people to use the feature.
Video placeholder on the page - I think we might as well remove it, as it clutters the page and does not necessarily need an explanation.

Small copy updates

1. We only show it for videos that include an audio track, and that are also of sufficient size and play length.
   ->
   We only show it for videos longer than 45 seconds that include an audio track.

2. Small nitpick - we use Picture-in-Picture in some instances, and picture-in-picture in others.

Comment 1

[Ania]

Attachment: context menu.png

Comment 2

[Ania]

Attachment: PIP 01 with CC windows.png

Comment 3

[Ania]

Attachment: disable pip in settings.png

Comment 4

[Ania]

Attachment: toggle hover.png

Comment 5

[Ania]

Fabi, tagging you here just in case.

Comment 6

[Ania]

Confirmed with the content design team that we should use "Picture-in-Picture" based on our content guidelines.

We should probably update this article on how to disable PiP, too.

Comment 7

[skibinvitaliy]

Comment on attachment 9319101 [details]
PiP windows

How does this PIP window have rounded corners for you?
This is something that I have been asking for a long time.