Closed Bug 1910697 Opened 3 months ago Closed 2 months ago

Update Reader View SuMo kb article [Desktop 129]

Categories

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

Tracking

(Not tracked)

RESOLVED FIXED

People

(Reporter: cmkm, Assigned: lsiebert)

References

()

Details

Attachments

(5 files)

Did you check out the steps and FAQs for submitting requests to the CX content team? (yes or no)? [REQUIRED]

**Note: Learn more at https://mozilla-hub.atlassian.net/wiki/spaces/MSS/pages/21430745/Mozilla+Support+Content **

IMPORTANT NOTICE: FOR TIMELY PUBLICATION, CONTENT REQUESTS MUST BE SUBMITTED AT LEAST 14 DAYS BEFORE THE RELEASE DATE, ENABLING THE SUMO TEAM TO MAKE THEM LIVE WITHIN 48 HOURS POST-RELEASE. PLEASE ENSURE THAT ALL SUBMITTED INFORMATION, INCLUDING FEATURE DETAILS AND VISUAL ASSETS, IS FINAL. IN THE EVENT OF ANY UNFORESEEN CHANGES OR DELAYS NECESSITATING A PUSH TO A SUBSEQUENT RELEASE, PROMPTLY INFORM US TO PREVENT PUBLISHING AS PER THE ORIGINAL SCHEDULE.

Yes, I have reviewed the FAQ guidelines.

Content access restriction: Is the content restricted to staff or under embargo (yes or no)? [REQUIRED]

Note: If yes, ensure ‘Advanced Fields’ are visible by selecting ‘Show Advanced Field’ at the top right, then scroll to ‘Security’ and check ‘Confidential Mozilla Employee Bug (non-security)’.

Attention: Any content not marked as confidential will be accessible to both NDAd and non-NDAd contributors with a Bugzilla account. Drafts for non-confidential content will also follow the same access policy, being open to comments for anyone with the link. Non-confidential Bugzillas can benefit from contributions by community contributors, while confidential Bugzillas will be handled exclusively by staff.

No, this content is not under embargo.

Product (ensure to select only one product for each ticket. If your request involves multiple products, file an individual Bugzilla for each)

Choose one below and delete others. [REQUIRED]
Firefox for Desktop (Windows)
Firefox for Desktop (macOS)
Firefox for Desktop (Linux)

Select the type of request.

Choose one or more below and delete others. [REQUIRED]
KB content update/ new content

Please summarize the request, emphasizing any user-facing changes. Include historical context or background information if it helps users understand the new features or changes. [REQUIRED]

##Are the user-facing changes mentioned above for the production release, or is the feature/change experimental/ beta? (Production, Experimental or Beta) [REQUIRED]
**Note: Specify if the user-facing changes mentioned above are final, experimental, or in beta. This information is crucial for determining the appropriate support and documentation level needed. Please note that SUMO KB articles only support the production version for Firefox.

These finalized changes are available in production. The look and feel of the menus in Desktop Reader View have been updated. New functionality has been added, including the ability to add custom color schemes and additional text formatting options.

Are the new features or changes region-specific? Are they going to be released in a gradual rollout? [REQUIRED]

**Note: Please confirm if these features or changes are limited to specific geographic regions and if they will be implemented gradually. Knowing this helps us tailor our documentation and support resources appropriately.

No, not region-specific.

Please indicate if this is an on- or off-train release [REQUIRED]

**Note: If applicable, add the product version number to the end of the Summary field using the format: Summary [Product V123]. If this is an off-train release, please use the format: Summary [Product off-train].

On-train release.

What is the anticipated release date? [REQUIRED]

Note: Content is typically published at, or within, 48 hours of the release.

Anticipated at release.

Does the content need to be published prior to the release date? If so, when? [REQUIRED]

Note: If you don’t let us know if this date changes, it will be published on this date

No.

Does the content need to be localized in any languages outside of EN-US? If yes, please indicate which languages. [REQUIRED]

Note: A minimum of 10 days is required for translation requests.

Yes, all languages

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

Bug 1874981 - [Meta] Reader View Comfort Settings

Please include links to any design assets, visuals, figma files, etc. [REQUIRED]

Note: Ensure to submit only final visual assets relevant to the Production release, excluding Nightly or Beta images, and favor 'Light mode' UI screenshots over 'Dark mode'

See attachments.

Please add instructions for testing that will enable us to replicate the expected product behavior. [REQUIRED]

The prefs reader.improved_text_menu.enabled and reader.colors_menu.enabled should both be true, which should be the default behavior in 129 (Bug 1899366 - Flip prefs to enable new text and layout + theme menus by default).

Does the content need approval before publishing? If yes, identify the one approver responsible for this task.

Note: Minor changes such as string updates are directly handled in SUMO, and will not lead to the generation of a pre-publishing draft. [REQUIRED]

Yes, Cieara :cmkm can approve

Summary [Product V129]

Flags: needinfo?(ini)
Assignee: nobody → lsiebert

The color themes were previously located alongside the other text formatting options, and they've now moved to their own menu item.

Attached image Custom theme menu.

Many thanks to @cmkm for filing this request and creating the screenshots while I was on PTO! Everything looks good to me, and the screenshots cover all the new updates. One thing I'd like to emphasize is that the new text formatting options (under the Advanced section) are accessibility-focused features. Character spacing and word spacing in particular can help improve reading fluency, in accordance with the WCAG AA guidelines. It could be helpful to highlight this purpose as most users will be unfamiliar with character and word spacing.

Flags: needinfo?(ini)

Additionally, part of the new functionality includes the ability to add additional fonts to choose from in Reader View. Right now, the only way to do that is by editing an array stored in a pref via about:config.

The steps would be:
about:config -> Search reader.font_type.values
Add the new font in the array
Reload Reader View by refreshing the page
Find the new font you’ve added in the dropdown

This is a feature that users have requested often, but it was out of scope for this project to build an in-UI method for importing fonts. I understand we want to avoid about:config in the article itself, but it would great if there was a way for tech-savvy users to discover this feature. This could be accomplished through a SUMO forum thread, or a11y has also suggested linking to a Mozilla Hacks blog post that highlights accessibility features and workarounds in Reader View.

That is not really how the Support Forum operates (it is more of a place for users to ask support questions), but I am working on an equiavlent situation (different project) and we are looking to do a MDN Hacks blog - a better place for that type of content still keeping it within Mozilla, but away from SUMO (and a better place for a hack like that).

(In reply to Irene Ni from comment #8)

<snip> a11y has also suggested linking to a Mozilla Hacks blog post that highlights accessibility features and workarounds in Reader View.

In case it helps, there's a SUMO KB article about accessibility features in Firefox.

Hey Cieara! I’ve just submitted a revision to the current article. Could you please take a look and let me know if it’s good to go live? Thanks!

Flags: needinfo?(cmeador)

Hey Lucas, thanks for working on the article! I'm the lead engineer on this project. Looks great overall, one small nit:

  • Under Font Style, there are Serif, Sans-serif, and Monospace options.
  • The font weights available are Light, Regular, and Bold.
Flags: needinfo?(cmeador)

(In reply to Irene Ni from comment #12)

Hey Lucas, thanks for working on the article! I'm the lead engineer on this project. Looks great overall, one small nit:

  • Under Font Style, there are Serif, Sans-serif, and Monospace options.
  • The font weights available are Light, Regular, and Bold.

Hi Irene! I really appreciate you reviewing it on such short notice. It’s been pretty hectic the past few days, so I apologize for not getting the draft to you sooner. I’ve updated the font info and made the content live. Let me know if any more tweaks are needed.

Updated article:

Status: NEW → RESOLVED
Closed: 2 months ago
Resolution: --- → FIXED
You need to log in before you can comment on or make changes to this bug.

Attachment

General

Creator:
Created:
Updated:
Size: