From dc4bbc2b27a6342f26a82644e1c7b514de73689e Mon Sep 17 00:00:00 2001 From: Maxime Jobin Date: Thu, 2 May 2019 09:38:41 -0400 Subject: [PATCH 1/3] Update the text as Gutenberg was officially released. --- docs/designers-developers/faq.md | 42 ++++++++++++++++---------------- 1 file changed, 21 insertions(+), 21 deletions(-) diff --git a/docs/designers-developers/faq.md b/docs/designers-developers/faq.md index 9bd9c8fae2530a..6f72305c04b855 100644 --- a/docs/designers-developers/faq.md +++ b/docs/designers-developers/faq.md @@ -18,7 +18,7 @@ Gutenberg is being developed on [GitHub](https://github.com/WordPress/gutenberg) ## When will Gutenberg be merged into WordPress? -Gutenberg will be merged into WordPress 5.0, and will be released at the end of 2018, or early 2019. Please follow [WordPress.org News](https://wordpress.org/news/) for the latest information. +Gutenberg was be merged into [WordPress 5.0](https://wordpress.org/news/2018/12/bebo/) that was released in December 2018. The editor focus started in early 2017 with the first three months spent designing, planning, prototyping, and testing prototypes, to help us inform how to approach this project. The actual plugin, which you can install from the repository, was launched during WordCamp Europe in June. @@ -37,7 +37,7 @@ As we thought about these uses and how to make them obvious and consistent, we b ## What is the writing experience like? -Our goal with Gutenberg is not just to create a seamless post- and page-building experience. We also want to ensure that it provides a seamless writing experience. Though individual paragraphs of text will become their own “blocks,” the creation and editing of these blocks are being designed in a way that could be just as simple—if not more so—than the current WordPress editor experience. Here is a brief animation illustrating the Gutenberg writing experience: +Our goal with Gutenberg is not just to create a seamless post- and page-building experience. We also want to ensure that it provides a seamless writing experience. Though individual paragraphs of text become their own “blocks,” the creation and editing of these blocks are being designed in a way that could be just as simple—if not more so—than the current WordPress editor experience. Here is a brief animation illustrating the Gutenberg writing experience: ![Typing](https://make.wordpress.org/core/files/2017/10/gutenberg-typing-1_6.gif) @@ -243,9 +243,9 @@ Here is a brief animation illustrating how to find and use the keyboard shortcut No. [TinyMCE](https://www.tinymce.com/) is only used for the "Classic" block. -## What browsers will Gutenberg support? +## What browsers do Gutenberg support? -Gutenberg will work in modern browsers, and Internet Explorer 11. +Gutenberg works in modern browsers, and Internet Explorer 11. Our [list of supported browsers can be found in the Make WordPress handbook](https://make.wordpress.org/core/handbook/best-practices/browser-support/). By “modern browsers” we generally mean the *current and past two versions* of each major browser. @@ -257,7 +257,7 @@ The API for creating blocks is a crucial aspect of the project. We are working o No, we are designing Gutenberg primarily as a replacement for the post and page editing screens. That said, front-end editing is often confused with an editor that looks exactly like the front end. And that is something that Gutenberg will allow as themes customize individual blocks and provide those styles to the editor. Since content is designed to be distributed across so many different experiences—from desktop and mobile to full-text feeds and syndicated article platforms—we believe it's not ideal to create or design posts from just one front-end experience. -## Given Gutenberg is built in JavaScript, how will old meta boxes (PHP) work? +## Given Gutenberg is built in JavaScript, how do old meta boxes (PHP) work? We plan to continue supporting existing meta boxes while providing new ways to extend the interface. @@ -267,21 +267,21 @@ We plan to continue supporting existing meta boxes while providing new ways to e The main extension point we want to emphasize is creating new blocks. We are still working on how to extend the rest of the UI that is built in JS. We are tracking it here: [Issue #1352](https://github.com/WordPress/gutenberg/issues/1352) -## Will Custom Post Types be supported? +## Are Custom Post Types still supported? Indeed. There are multiple ways in which custom post types can leverage Gutenberg. The plan is to allow them to specify the blocks they support, as well as defining a default block for the post type. It's not currently the case, but if a post type disables the content field, the “advanced” section at the bottom would fill the page. -## Will there be columns? +## Does Gutenberg support columns? Yes, a columns block is available in Gutenberg. -## Will there be nested blocks? +## Does Gutenberg support nested blocks? We are currently implementing the infrastructure for nested blocks support. We expect this to open further customization opportunities. Block authors also can nest components and HTML inside of a block during construction. The UI for manipulating nested blocks is still being refined, and depending on the timing, it might not be included in the first version of Gutenberg. See also [Issue #428](https://github.com/WordPress/gutenberg/issues/428) -## Will drag and drop be used for rearranging blocks? +## Does drag and drop work for rearranging blocks? Yes, you can drag and drop blocks to rearrange their order. @@ -289,17 +289,17 @@ Yes, you can drag and drop blocks to rearrange their order. Yes. Blocks can provide their own styles, which themes can add to or override, or they can provide no styles at all and rely fully on what the theme provides. -## How will block styles work in both the front-end and back-end? +## How do block styles work in both the front-end and back-end? -Blocks will be able to provide base structural CSS styles, and themes can add styles on top of this. Some blocks, like a Separator (`
`), likely won't need any front-end styles, while others, like a Gallery, need a few. +Blocks are able to provide base structural CSS styles, and themes can add styles on top of this. Some blocks, like a Separator (`
`), likely don't need any front-end styles, while others, like a Gallery, need a few. -Other features, like the new _wide_ and _full-wide_ alignment options, will simply be CSS classes applied to blocks that offer this alignment. We are looking at how a theme can opt in to this feature, for example using `add_theme_support`. +Other features, like the new _wide_ and _full-wide_ alignment options, are simply CSS classes applied to blocks that offer this alignment. We are looking at how a theme can opt in to this feature, for example using `add_theme_support`. *See:* [Theme Support](/docs/designers-developers/developers/themes/theme-support.md) -## How will editor styles work? +## How do editor styles work? -Regular editor styles are opt-in and will work as is in most cases. Themes can also load extra stylesheets by using the following hook: +Regular editor styles are opt-in and work as is in most cases. Themes can also load extra stylesheets by using the following hook: ```php function gutenbergtheme_editor_styles() { @@ -318,22 +318,22 @@ Aside from enabling a rich post and page building experience, a meta goal is to We realize it's a big change. We also think there will be many new opportunities for plugins. WordPress is likely to ship with a range of basic blocks, but there will be plenty of room for highly tailored premium plugins to augment existing blocks or add new blocks to the mix. -## Will I be able to opt out of Gutenberg for my site? +## Is it possible to opt out of Gutenberg for my site? There is a “Classic” block, which is virtually the same as the current editor, except in block form. There is also the [Classic Editor plugin](https://wordpress.org/plugins/classic-editor/) which restores the previous editor, see the plugin for more information. The WordPress Core team has committed to supporting the Classic Editor plugin [until December 2021](https://make.wordpress.org/core/2018/11/07/classic-editor-plugin-support-window/). -## How will custom TinyMCE buttons work in Gutenberg? +## How do custom TinyMCE buttons work in Gutenberg? -Custom TinyMCE buttons will still work in the “Classic” block, which is a block version of the classic editor you know today. +Custom TinyMCE buttons still work in the “Classic” block, which is a block version of the classic editor you know today. (Gutenberg comes with a new universal inserter tool, which gives you access to every block available, searchable, sorted by recency and categories. This inserter tool levels the playing field for every plugin that adds content to the editor, and provides a single interface to learn how to use.) -## How will shortcodes work in Gutenberg? +## How do shortcodes work in Gutenberg? -Shortcodes will continue to work as they do now. +Shortcodes continue to work as they do now. However we see the block as an evolution of the `[shortcode]`. Instead of having to type out code, you can use the universal inserter tray to pick a block and get a richer interface for both configuring the block and previewing it. We would recommend people eventually upgrade their shortcodes to be blocks. @@ -341,7 +341,7 @@ However we see the block as an evolution of the `[shortcode]`. Instead of having We think so. Blocks are designed to be visually representative of the final look, and they will likely become the expected way in which users will discover and insert content in WordPress. -## Will Gutenberg be made properly accessible? +## Is Gutenberg made to be properly accessible? Accessibility is not an afterthought. Not every aspect of Gutenberg is accessible at the moment. You can check logged issues [here](https://github.com/WordPress/gutenberg/labels/Accessibility). We understand that WordPress is for everyone, and that accessibility is about inclusion. This is a key value for us. @@ -378,7 +378,7 @@ As part of the focus on the editor in 2017, a focus on customization and sitebui With the editor, we lay the foundation for bigger things when it comes to page building and customization. -A lot of features are planned, too many to list. But a rough roadmap is: v1) post and page editor v2) page template editor, v3) site builder. +A lot of features are planned, too many to list here. You can check [Gutenberg's roadmap](https://github.com/WordPress/gutenberg/blob/master/docs/roadmap.md) for more details. ## WordPress is already the world's most popular publishing platform. Why change the editor at all? As an open-source project, we believe that it is critical for WordPress to continue to innovate and keep working to make the core experience intuitive and enjoyable for all users. As a community project, Gutenberg has the potential to do just that, and we're excited to pursue this goal together. If you'd like to test, contribute, or offer feedback, [we welcome it here](http://wordpressdotorg.polldaddy.com/s/gutenberg-support). From d445e5e09b82a68ce06c81aa271ddfdce318e2c9 Mon Sep 17 00:00:00 2001 From: Chris Van Patten Date: Fri, 3 May 2019 09:06:18 -0400 Subject: [PATCH 2/3] Update docs/designers-developers/faq.md Co-Authored-By: maximejobin --- docs/designers-developers/faq.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/designers-developers/faq.md b/docs/designers-developers/faq.md index 6f72305c04b855..7c66e3294eb583 100644 --- a/docs/designers-developers/faq.md +++ b/docs/designers-developers/faq.md @@ -243,7 +243,7 @@ Here is a brief animation illustrating how to find and use the keyboard shortcut No. [TinyMCE](https://www.tinymce.com/) is only used for the "Classic" block. -## What browsers do Gutenberg support? +## What browsers does Gutenberg support? Gutenberg works in modern browsers, and Internet Explorer 11. From a4e7b713222e9502d87834901521f3c9c47fad64 Mon Sep 17 00:00:00 2001 From: Maxime Jobin Date: Mon, 6 May 2019 21:43:01 -0400 Subject: [PATCH 3/3] Change nested blocks answer. --- docs/designers-developers/faq.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/docs/designers-developers/faq.md b/docs/designers-developers/faq.md index 7c66e3294eb583..97fa21f772281e 100644 --- a/docs/designers-developers/faq.md +++ b/docs/designers-developers/faq.md @@ -18,7 +18,7 @@ Gutenberg is being developed on [GitHub](https://github.com/WordPress/gutenberg) ## When will Gutenberg be merged into WordPress? -Gutenberg was be merged into [WordPress 5.0](https://wordpress.org/news/2018/12/bebo/) that was released in December 2018. +Gutenberg was merged into [WordPress 5.0](https://wordpress.org/news/2018/12/bebo/) that was released in December 2018. The editor focus started in early 2017 with the first three months spent designing, planning, prototyping, and testing prototypes, to help us inform how to approach this project. The actual plugin, which you can install from the repository, was launched during WordCamp Europe in June. @@ -277,9 +277,7 @@ Yes, a columns block is available in Gutenberg. ## Does Gutenberg support nested blocks? -We are currently implementing the infrastructure for nested blocks support. We expect this to open further customization opportunities. Block authors also can nest components and HTML inside of a block during construction. The UI for manipulating nested blocks is still being refined, and depending on the timing, it might not be included in the first version of Gutenberg. - -See also [Issue #428](https://github.com/WordPress/gutenberg/issues/428) +Yes, it is supported. You can have multiple levels of nesting – blocks within blocks within blocks. ## Does drag and drop work for rearranging blocks?