search

WordPress / Documentation-Issue-Tracker

Issue Tracker for the WordPress Documentation team.
https://make.wordpress.org/docs/
Other
83 stars 41 forks source link

Add distraction free writing article #793

Open annezazu opened 1 year ago

annezazu commented 1 year ago

Issue Description

WordPress 6.2 introduces distraction free mode and the current distraction free writing experience is missing this important new feature.

URL of the Page with the Issue

https://make.wordpress.org/support/user-manual/editors/distraction-free-writing/

Suggested Fix

Update the doc with distraction free mode references.

Props to @pablohoneyhoney for finding this and noting it.

Unless someone beats me to it, I'll aim to get this updated next week and will report back if I don't.

zzap commented 1 year ago

Heads up @WordPress/docs-issues-coordinators, we have a new issue open. Time to use 'em labels.

annezazu commented 1 year ago

We also need to likely create a new doc in the official support repo too: https://wordpress.org/search/distraction+free/

Right now though, it seems this pops up pretty highly when searching for distraction free writing. I'll try to tackle both or have it be something we can cross reference.

ndiego commented 1 year ago

I want to note that this root URL has multiple out-of-date docs. I wonder if the "user manual" was an old docs resource that was deprecated. Here are a few examples:

There does not appear to be a direct way to access this "user manual" without a direct URL. Perhaps a solution would be to de-index the pages and/or remove them entirely. I know removing pages is generally not advised, though.

annezazu commented 1 year ago

Great point. I'm not sure either. Curious to hear from others and am happy to update this only to have it deprecated later :). Worst case, it can all be used for a Support Article.

annezazu commented 1 year ago

Noting a discussion with @Clorith in Make Slack: https://wordpress.slack.com/archives/C02RQC6RW/p1681491802504319 TLDR: likely can be deprecated and redirected. I'll aim for a new doc we can redirect to at least :)

annezazu commented 1 year ago

Because there are quite a few tasks here, here's what I'm planning to do. I welcome help!

Note: using the phrasing "Distraction Free mode" pulled from the 6.2 release announcement for consistency.

annezazu commented 1 year ago

@Clorith mind redirecting https://make.wordpress.org/support/user-manual/editors/distraction-free-writing/ to https://wordpress.org/documentation/article/distraction-free-mode/ and checking off the above when done? I'll note this in slack as well in case this doesn't notify you <3

mrfoxtalbot commented 1 year ago

I think that the current article is still relevant considering that the Classic Editor plugin has 5M+ active installs. I have gone ahead and added a notice to the original article explaining it is about the classic editor and linking to the new one.

This support article is about the classic editor. If you are using the new block editor, you can learn about the Distraction Free writing mode here.

What do you think @Clorith, @annezazu?

annezazu commented 1 year ago

I don't have enough historical knowledge of this section of the Make Support site to give an informed opinion. From what was shared in slack, it seems like these pages were precursors to the support site. As an alternative, what if we redirected but still shared links to using the classic editor in the new doc? I'd rather we have folks land in the official support docs from a search engine than a dead end.