Skip to content

Docs: Move design docs to user interface explanations#37807

Merged
mkaz merged 4 commits into
trunkfrom
docs/design-to-ui
Feb 5, 2022
Merged

Docs: Move design docs to user interface explanations#37807
mkaz merged 4 commits into
trunkfrom
docs/design-to-ui

Conversation

@mkaz
Copy link
Copy Markdown
Member

@mkaz mkaz commented Jan 9, 2022

Description

The designer documentation is under the How to guides section which is a section intended to explain a specific task. These documents are a general explanation on how the user interface is designed, so this PR moves the docs to the Explanations section.

Additionally, they are renamed to "User Interface" instead of "designers documentation" because they are not role specific docs but information specific, developers and designers both have interest in the user interface. This change is similar to how we moved developer docs to Architecture under explanations.

The goal of this change makes the repository more consistent and easier to find both explanations documents, but additional how to guides since it removes some clutter from there.

A small bonus with this change the image assets used in the moved docs were removed out of the repo to developer.wordpress.org media library.

How has this been tested?

Difficult to confirm since it relies solely on the publishing.

The content of the pages were not changed, just moved. The slugs were also kept the same so WordPress should auto resolve the new locations without needing additional redirects.

Types of changes

Documentation.

  • Move design docs to explanations
  • Update table of contents with user interface section
  • Update assets reference to developer.wp.org media
  • Update link to design resources

@mkaz mkaz requested a review from ajitbohra as a code owner January 9, 2022 15:37
@mkaz mkaz added the [Type] Developer Documentation Documentation for developers label Jan 9, 2022
@mkaz mkaz force-pushed the docs/design-to-ui branch from 1cb2c5e to 486addb Compare February 4, 2022 17:17
Copy link
Copy Markdown
Contributor

@ryanwelcher ryanwelcher left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! 👍

@mkaz mkaz merged commit 0fb3492 into trunk Feb 5, 2022
@mkaz mkaz deleted the docs/design-to-ui branch February 5, 2022 00:07
@github-actions github-actions Bot added this to the Gutenberg 12.6 milestone Feb 5, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

[Type] Developer Documentation Documentation for developers

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants