Skip to content

Commit

Permalink
docs(pie-docs): copy updates to what is pie and our vision (#318)
Browse files Browse the repository at this point in the history
* docs(pie-docs): copy updates to what is pie and our vision

* cosmetic(pie-docs): add ? to What is PIE nav key
  • Loading branch information
jamieomaguire authored Mar 15, 2023
1 parent 6827817 commit ac90c2e
Show file tree
Hide file tree
Showing 4 changed files with 21 additions and 11 deletions.
5 changes: 5 additions & 0 deletions .changeset/nervous-planets-sip.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"pie-docs": minor
---

[Changed] - Add question mark to What is PIE? nav key
5 changes: 5 additions & 0 deletions .changeset/tough-guests-yawn.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"pie-docs": minor
---

[Changed] - Copy in What is PIE? and Our Vision pages based on ux feedback
2 changes: 1 addition & 1 deletion apps/pie-docs/src/all-about-pie/our-vision-principles.json
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@
"headingText": "Inclusive",
"imgSrc": "../../assets/img/all-about-pie/our-vision/inclusive.svg",
"imgSrcNarrow": "../../assets/img/all-about-pie/our-vision/inclusive.svg",
"text": "* Our output is for everyone: combining accessibility with the best design practices.\n * We design and build with consumers, end users, creatives and engineers in mind.\n * Our output makes our products more intuitive and easy to use."
"text": "* PIE is for everyone: combining accessibility with the best design practices.\n * We design and build with consumers, end users, creatives and engineers in mind.\n * Our output makes our products more intuitive and easy to use."
},
{
"headingText": "Effective",
Expand Down
20 changes: 10 additions & 10 deletions apps/pie-docs/src/all-about-pie/what-is-pie.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
eleventyNavigation:
key: What is PIE
key: What is PIE?
parent: All about PIE
order: 1
title: What is PIE?
Expand All @@ -9,16 +9,16 @@ description: Principles for Interfaces and Experiences (PIE) is Just Eat Takeawa

## Overview

A **design system** is like a recipe for creating visually appealing and user-friendly products. Just as a recipe has different ingredients and instructions for cooking a delicious meal, a design system has different components, patterns and documentation which help us when designing digital products such as websites or apps.
A **design system** is like a recipe for creating visually appealing and user-friendly products. Just as a recipe uses ingredients and instructions to help you make a delicious meal, a design system uses components, patterns and documentation to help us design amazing apps and websites.

For example, just as a recipe might call for specific amounts of ingredients and cooking times to ensure a perfect dish, a design system might dictate certain font sizes, colour palettes, and layout rules to ensure consistency and usability across all JET products.
For example, just as a recipe details the specific amounts of ingredients and cooking time needed, a design system details the font sizes, colour palettes and layout rules to ensure consistency and usability across all JET products.

In both cases, following the recipe or design system instructions helps to ensure a consistent and high-quality end result.
In both cases, following the recipe makes it easy to produce consistently great results that can be replicated time and time again.

{% contentPageImage {
src: "../../assets/img/all-about-pie/what-is-pie/[email protected]",
mobileSrc: "../../assets/img/all-about-pie/what-is-pie/ingredients_[email protected]",
caption: "Much like a delicious meal, our design system is made of multiple ingredients which can be used to create high quality products."
caption: "Much like the recipe for a delicious meal, our design system makes use of multiple ingredients to create high-quality products."
} %}

---
Expand All @@ -34,8 +34,8 @@ Here are six reasons why you should use PIE for your products:
items: [
"**Consistency**: PIE provides a single source of truth for designers and developers, which keeps your products consistent and minimises the chance of human errors.",
"**Reusability**: We design and build reusable and scalable components that can be used throughout our products by designers, developers and other teams.",
"**Craft & Quality**: We have specialist developers and designers focusing their energy on crafting and maintaining our design system, and who are here to support you at any time.",
"**Accessibility**: We make sure that we design and build with all users in mind. We have accessibility built in from the start and test accessibility every step of the way.",
"**Craft & Quality**: Our specialist developers and designers focus their energy on crafting and maintaining the design system, and they're here to support you and your products.",
"**Accessibility**: We design and build with all users in mind. Accessibility is built in from the start and tested at every step of the process.",
"**Efficiency**: By using our library of pre-designed and -built components, you can work faster and focus your energy on solving new problems instead of rebuilding the same assets.",
"**Alignment**: No matter if you are a designer, iOS, Web or Android developer, PIE provides you with a common language and goal."
]
Expand All @@ -45,8 +45,8 @@ Here are six reasons why you should use PIE for your products:

## How we support teams

PIE is both a service and a product to the organisation. We create and maintain its contents and guidelines, but we also support other teams through [business area libraries](https://www.figma.com/file/KND7Higqcvksz7WkXRKLHm/PIE-Microsite?node-id=3204%3A188255&t=CBkGw0yndbtBW9TK-0){target="_blank"}.
PIE is both a service and a product. We create and maintain its contents and guidelines, and also support other teams through [business area libraries](https://www.figma.com/file/KND7Higqcvksz7WkXRKLHm/PIE-Microsite?node-id=3204%3A188255&t=CBkGw0yndbtBW9TK-0){target="_blank"}.

Our goal with these isnt to take ownership from designers. Instead, we are here to support these teams and ensure their products align to the system, preserving scalability, consistency and craft.
Our goal isn't to take ownership of design from designers. We're here to support you and ensure all JET's products align to the system, providing scalability, consistency and high levels of craft.

You can learn more about our **support models** in our [How we support you](/designers/how-we-support-you) page.
[Learn more about our support models](/designers/how-we-support-you).

0 comments on commit ac90c2e

Please sign in to comment.