gitlab-org--gitlab-foss/doc/development/ux_guide/surfaces.md

# Surfaces

## Contents
* [Header](#header)
* [Global menu](#global-menu)
* [Side pane](#side-pane)
* [Content area](#content-area)

---

![Surfaces UX](img/surfaces-ux.png)

## Global menu

This menu is to navigate to pages that contain content global to GitLab.

---

## Header

The header contains 3 main elements: Project switching and searching, user account avatar and settings, and a contextual menu that changes based on the current page.

![Surfaces Header](img/surfaces-header.png)

---

## Side pane

The side pane holds supporting information and meta data for the information in the content area.

---

## Content area

The main content of the page. The content area can include other surfaces.

### Item title bar

The item title bar contains the top level information to identify the item, such as the name, id and status.

![Item title](img/surfaces-contentitemtitle.png)

### Item system information

The system information block contains relevant system controlled information.

![Item system information](img/surfaces-systeminformationblock.png)
[ci skip] Establish basic structure for ux_guide README.md Block out pages needed for ux_guide Add resources stub to ux_guide home Fill out principles and basics Add TOC to basics Move all of UI guide to new UX guide structure Add first level structure on ux-guide pages Add more details to buttons Add button images. Update link on development Renamed surfaces to templates. Add tooltip details Update typography and icons on Basics page Add images for color. First draft of voice and tone Delete findings page Refine pages. Fill out Surfaces pages Clean up layout on basics, surfaces, features. Add anchorlinks and counts to components Fill out components page Add item title and system info block Fill out Features page Switch tooltip placement image 2016-10-21 17:25:09 -04:00			`# Surfaces`

			`## Contents`
			`* [Header](#header)`
			`* [Global menu](#global-menu)`
			`* [Side pane](#side-pane)`
			`* [Content area](#content-area)`

			`---`

			`![Surfaces UX](img/surfaces-ux.png)`

			`## Global menu`

			`This menu is to navigate to pages that contain content global to GitLab.`

			`---`

			`## Header`

			`The header contains 3 main elements: Project switching and searching, user account avatar and settings, and a contextual menu that changes based on the current page.`

			`![Surfaces Header](img/surfaces-header.png)`

			`---`

			`## Side pane`

			`The side pane holds supporting information and meta data for the information in the content area.`

			`---`

			`## Content area`

			`The main content of the page. The content area can include other surfaces.`

			`### Item title bar`

			`The item title bar contains the top level information to identify the item, such as the name, id and status.`

			`![Item title](img/surfaces-contentitemtitle.png)`

			`### Item system information`

			`The system information block contains relevant system controlled information.`

Remove <br> and replace GFM blockquote with the Markdown general [ci skip] 2016-11-11 12:20:56 -05:00			`![Item system information](img/surfaces-systeminformationblock.png)`