From 7b68e34bb04d18619dbe4140e870a4d6bb28873d Mon Sep 17 00:00:00 2001 From: Nick Diego Date: Thu, 7 Sep 2023 13:51:23 -0500 Subject: [PATCH] Consolidated design reference with the design contributions doc. (#51065) --- .../assets/gutenberg-logo-black.svg} | 0 docs/contributors/design/README.md | 27 +++---------------- docs/contributors/design/reference.md | 18 ------------- docs/manifest.json | 6 ----- docs/toc.json | 3 +-- 5 files changed, 4 insertions(+), 50 deletions(-) rename docs/{final-g-wapuu-black.svg => contributors/assets/gutenberg-logo-black.svg} (100%) delete mode 100644 docs/contributors/design/reference.md diff --git a/docs/final-g-wapuu-black.svg b/docs/contributors/assets/gutenberg-logo-black.svg similarity index 100% rename from docs/final-g-wapuu-black.svg rename to docs/contributors/assets/gutenberg-logo-black.svg diff --git a/docs/contributors/design/README.md b/docs/contributors/design/README.md index acf1b6cc9b2342..b145b008f2e8d7 100644 --- a/docs/contributors/design/README.md +++ b/docs/contributors/design/README.md @@ -20,7 +20,9 @@ The [WordPress Design team](http://make.wordpress.org/design/) uses [Figma](http This section outlines the design principles and patterns of the editor interface—to explain the background of the design, inform future improvements, and help people design great blocks. -![Gutenberg Logo](https://cldup.com/J2MgjuShPv-3000x3000.png) +Gutenberg Logo + +The Gutenberg logo was made by [Cristel Rossignol](https://twitter.com/cristelrossi), and is released under the GPL license. [Download the SVG logo](/docs/contributors/assets/gutenberg-logo-black.svg). ### Goal of Gutenberg @@ -57,26 +59,3 @@ Gutenberg wants to make it easier to author rich content. This means ensuring go **Direct manipulation is intuitive.** The block interface allows users to manipulate content directly on the page. Plugin and theme authors will support and extend this experience by building their own custom blocks. **Code editing shouldn't be necessary for customization.** Customizing traditionally required complicated markup, and complicated markup is easy to break. With Gutenberg, customizing becomes more intuitive — and safer. A developer will be able to provide custom blocks that directly render portions of a layout (a three column grid of features, for instance) and clearly specify what can be directly edited by the user. That means the user can update text, swap images, reduce the number of columns, without having to ask a developer, or worrying about breaking things. - -### Future Opportunities - -The initial phase of Gutenberg as described in the kickoff goal is primarily limited to the content area (specifically `post_content`) of posts and pages. Within those confines, we are embracing the web as a vertical river of content by appending blocks sequentially, then adding layout options to each block. - -That said, there isn’t any fixed limit to the kind of layouts Gutenberg will be able to create. It’s very possible for Gutenberg to grow beyond the confines of post and page content, to include the whole page — one could think of a theme template as a comma-separated list of blocks, like this: - -```js -{ - 'theme/header', - 'theme/sidebar', - 'core/content' { - 'core/cover-image', - 'theme/author-card', - 'core/text', - }, - 'theme/footer', -} -``` - -Every block nested inside the content block would be _rearrangeable_. Every block would be _editable_. Every block would use the same API, and both the editor and the theme would load the same `style.css` file directly. In the end, both the editor/page builder and theme/front-end would appear near-identical, allowing for a true WYSIWYG experience. - -This concept is speculative, but it’s one direction Gutenberg could go in the future. diff --git a/docs/contributors/design/reference.md b/docs/contributors/design/reference.md deleted file mode 100644 index 04e026f60497e4..00000000000000 --- a/docs/contributors/design/reference.md +++ /dev/null @@ -1,18 +0,0 @@ -# Reference - -- [Glossary](/docs/getting-started/glossary.md) -- [Coding Guidelines](/docs/contributors/code/coding-guidelines.md) -- [Testing Overview](/docs/contributors/code/testing-overview.md) -- [Frequently Asked Questions](/docs/getting-started/faq.md) - -## Logo - -Gutenberg Logo - -Released under GPL license, made by [Cristel Rossignol](https://twitter.com/cristelrossi). - -[Download the SVG logo](https://github.com/WordPress/gutenberg/blob/HEAD/docs/final-g-wapuu-black.svg). - -## Mockups - -Mockup Sketch files are available in [the User Interface section](/docs/explanations/user-interface/design-resources.md). diff --git a/docs/manifest.json b/docs/manifest.json index f6643182df7541..3194044bcd0f4a 100644 --- a/docs/manifest.json +++ b/docs/manifest.json @@ -2297,12 +2297,6 @@ "markdown_source": "../docs/contributors/design/the-block.md", "parent": "design" }, - { - "title": "Reference", - "slug": "reference", - "markdown_source": "../docs/contributors/design/reference.md", - "parent": "design" - }, { "title": "Documentation Contributions", "slug": "documentation", diff --git a/docs/toc.json b/docs/toc.json index 1bbef72793976d..5cc3a606c4d2ed 100644 --- a/docs/toc.json +++ b/docs/toc.json @@ -386,8 +386,7 @@ }, { "docs/contributors/design/README.md": [ - { "docs/contributors/design/the-block.md": [] }, - { "docs/contributors/design/reference.md": [] } + { "docs/contributors/design/the-block.md": [] } ] }, {