1825062 - SUMO update for import from other browsers article [115]

Status: RESOLVED FIXED

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

Description

[Ania]

Product

Firefox - Desktop only change

Select the type of request

Major update to existing feature/functionality
Major change to existing article

What product version number does this change align with? [REQUIRED]

115
Please see the breakdown of released updates to the import experience by Firefox version here

115 articles
https://support.mozilla.org/en-US/kb/import-bookmarks-google-chrome

1. We are currently promoting Library entry point to import, but need to promote a new primary entry point into import from about:preferences.

2. The list of supported data types has changed and needs to be updated. New wizard will support the following data types:

• browsing history,
• bookmarks,
• saved logins and passwords,
• form autofill data - from 115 and forward

https://support.mozilla.org/en-US/kb/import-data-another-browser

1. We need to promote about:preferences entry point.
2. UI screenshots need to change to reflect the new wizard design.
3. Import bookmarks from the HTML section will need an update in 115 once we ship import from HTML inside the import wizard.

https://support.mozilla.org/en-US/kb/import-bookmarks-internet-explorer-or-microsoft-edge

1. The article needs a full update that describes the new flow and promotes the primary entry point in about:preferences.

New new functionality in the import
https://support.mozilla.org/en-US/kb/import-bookmarks-html-file

1. Import bookmarks from file is now available directly from the import wizard - please see the new flow here.
2. We should promote about:preferences entry point.
3. Payment methods import from Chromium browsers.

https://support.mozilla.org/en-US/kb/import-ie-favorites-other-computer

1. Importing bookmarks into Firefox section needs to be updated according to the new bookmarks HTML file import.

116 articles
https://support.mozilla.org/en-US/kb/importing-safari-data-firefox

1. We no longer need full access to import data from Safari (although users can still do it if they are willing to go this path).
   I think it would be more valuable to describe the new Safari import flow instead. Especially, since it now prompts users to bring bookmarks AND passwords from Safari.

https://support.mozilla.org/en-US/kb/import-data-another-browser

https://support.mozilla.org/en-US/kb/import-data-another-browser#w_import-extensions-from-chrome

1. We are going to support extensions import from Chrome in 116, and it would be helpful to add a section on how we do extensions import that we can link to from the import wizard screens.

What is the anticipated release date? [REQUIRED]

115 - 2023-07-04
116 - 2023-08-01

What is the proposed deadline for the content to be published? [REQUIRED]

2023-07-01
In 115, we will launch the new wizard for all existing users by default. New users will still be exposed to the old wizard in about:welcome only in 115.

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

Demo - the demo shows both variants of the import wizard

Figma Variant 2 - this is the variant that's going live
Bugzilla
Spec

You can also see the new import wizard in Nightly by flipping:
browser.migrate.content-modal.import-all.enabled pref to see Variant 2

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

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

Is the content embargoed (yes or no)?

No

Comment 1

[Ania]

Attachment: just import modals.zip

Comment 2

[Ania]

Attachment: import modals inside ui.zip

Comment 4

[Lucas Siebert]

FX115 updated articles:
https://support.mozilla.org/en-US/kb/import-bookmarks-google-chrome
https://support.mozilla.org/en-US/kb/import-data-another-browser
https://support.mozilla.org/en-US/kb/import-bookmarks-and-other-data-microsoft-edge
https://support.mozilla.org/en-US/kb/import-bookmarks-html-file
https://support.mozilla.org/en-US/kb/import-ie-favorites-other-computer

Comment 5

[Ania]

Thank you, Lucas, this is tremendous work on updating all of these!

A couple of small nitpicks/questions:

1. https://support.mozilla.org/en-US/kb/import-bookmarks-html-file
   Should we consider changing:
   "This article explains how to import an HTML bookmarks file formatted in the Netscape Bookmarks format."
   to
   "This article explains how to import an HTML bookmarks file exported from your previous browser." ?

I feel like mentioning Netscape Bookmarks format won't help users much (as it's unlikely they are putting the file together themselves), and it feels a bit intimidating.

2. https://support.mozilla.org/en-US/kb/import-bookmarks-google-chrome
   I wonder if we should just compress the article, as the steps to import are identical from multiple entry points, whether it's Library or Settings?

https://support.mozilla.org/en-US/kb/import-bookmarks-google-chrome
3. There's a small typo in the "Import from Library" section (see attached screenshot).

Comment 6

[Ania]

Attachment: Знімок екрана 2023-07-05 о 5.10.24 пп.png

Comment 7

[Alice Wyman]

(In reply to Ania from comment #5)

1. https://support.mozilla.org/en-US/kb/import-bookmarks-html-file
   Should we consider changing:
   "This article explains how to import an HTML bookmarks file formatted in the Netscape Bookmarks format."
   to
   "This article explains how to import an HTML bookmarks file exported from your previous browser." ?

Ania, I also contributed to the article updates. I already have a revision pending review to change that sentence to ''This article explains how to add bookmarks to Firefox from a file saved in HTML format.'' See https://support.mozilla.org/en-US/kb/import-bookmarks-html-file/history

2. https://support.mozilla.org/en-US/kb/import-bookmarks-google-chrome
   I wonder if we should just compress the article, as the steps to import are identical from multiple entry points, whether it's Library or Settings?

Import from Firefox Settings only applies to Firefox 113 and above. We need the Library instructions for older versions we still support, including 102esr. See https://support.mozilla.org/en-US/forums/knowledge-base-articles/711388#post-67193 on what versions we support (we should probably document this somewhere, maybe in the Article review and approval guidelines article).

Comment 8

[Alice Wyman]

(In reply to Ania from comment #5)

3. There's a small typo in the "Import from Library" section (see attached screenshot).

The typo was in the https://support.mozilla.org/en-US/kb/import-data-another-browser article. I have a pending revision to fix it. See
https://support.mozilla.org/en-US/kb/import-data-another-browser/history

Comment 9

[Alice Wyman]

(In reply to Ania from comment #5)

2. https://support.mozilla.org/en-US/kb/import-bookmarks-google-chrome
   I wonder if we should just compress the article, as the steps to import are identical from multiple entry points, whether it's Library or Settings?

I submitted a new revision to keep two sections to start the Import process (Library for all versions and Settings for fx113+) but combined steps to chose data and complete the import process. See: https://support.mozilla.org/en-US/kb/import-bookmarks-google-chrome/history
Lucas, can you review my revision and make any changes that may be needed?

Comment 10

[Alice Wyman]

(from comment #9)

I submitted a new revision to keep two sections to start the Import process (Library for all versions and Settings for fx113+) but combined steps to chose data and complete the import process. See: https://support.mozilla.org/en-US/kb/import-bookmarks-google-chrome/history
Lucas, can you review my revision and make any changes that may be needed?

Abby approved my revisions.