Skip to content

Commit

Permalink
[ENG-8954][docs] EAS Update: add pitch and revamp intro page (expo#23095
Browse files Browse the repository at this point in the history
)

# Why

When I ask GPT what the advantages between EAS Update vs our competitors
are and to talk about the tradeoffs, it lists some reasons that are no
longer true. This signals to me that there is outdated information in
our community and our pitch should aim to clarify these, in addition to
talking about the value propositions of the product.

# How

The pitch is meant to be a succinct 3-5 point blurb on why people should
use EAS Update. Here are the reasons why I chose each of the points:

1. Improve User Experience: the main value proposition of our product
2. Broad Compatibility: people think that you are 'locked in' to the
expo ecosystem if you use EAS Update, or that you cannot use EAS Update
if you have a bare RN app.
3. Tailored for Expo: explain that you do get extra value if you do use
other services like EAS Build, and what exactly those benefits are.
4. Customizable Update Strategies: GPT implies that EAS Update doesnt
give the user fined grained control via an API, which is not true (asked
over multiple prompts). We may need to do a better job of linking our
API/config in our docs so folks know they can create a custom update
strategy.

This PR also shortens the boxlink list to the main usecases of EAS
Update and the get started guide, in order to keep things brief.


# Test Plan

<!--
Please describe how you tested this change and how a reviewer could
reproduce your test, especially if this PR does not include automated
tests! If possible, please also provide terminal output and/or
screenshots demonstrating your test/reproduction.
-->

# Checklist

<!--
Please check the appropriate items below if they apply to your diff.
This is required for changes to Expo modules.
-->

- [ ] Documentation is up to date to reflect these changes (eg:
https://docs.expo.dev and README.md).
- [ ] Conforms with the [Documentation Writing Style
Guide](https://github.com/expo/expo/blob/main/guides/Expo%20Documentation%20Writing%20Style%20Guide.md)
- [ ] This diff will work correctly for `npx expo prebuild` & EAS Build
(eg: updated a module plugin).

---------

Co-authored-by: Aman Mittal <[email protected]>
  • Loading branch information
quinlanj and amandeepmittal authored Jun 27, 2023
1 parent 095e00d commit fccfbf3
Show file tree
Hide file tree
Showing 2 changed files with 20 additions and 20 deletions.
2 changes: 1 addition & 1 deletion docs/pages/eas-update/codepush.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ import { Collapsible } from '~/ui/components/Collapsible';
import { Terminal } from '~/ui/components/Snippet';
import { Step } from '~/ui/components/Step';

This guide explains how to transition a React Native project that uses CodePush to use EAS Update. It assumes that you are using the default React Native project structure. For assistance with migrating brownfield native apps to EAS Update, [reach out to us directly](https://expo.dev/contact).
This guide explains how to transition a React Native project that uses CodePush to use EAS Update which offers [many advantages](/eas-update/introduction/#pitch). It assumes that you're using the default React Native project structure. For assistance with migrating brownfield native apps to EAS Update, [reach out to us directly](https://expo.dev/contact).

## Prerequisites

Expand Down
38 changes: 19 additions & 19 deletions docs/pages/eas-update/introduction.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,25 @@ All apps running the `expo-updates` library have the ability to receive updates.

Still using Classic Updates? We moved those docs to [the archive](/archive/classic-updates/introduction).

### Get started
## Pitch

### Improve User Experience

EAS Update allows you to release hotfixes and enhancements in response to user feedback or market trends. It helps you keep users engaged and satisfied with your app. Don't wait for the next planned update or manual update request.

### Broad Compatibility

EAS Update works with vanilla React Native apps. All you need to do is install the lightweight `expo` npm package as a prerequisite, making it a compelling alternative to solutions such as [Codepush](/eas-update/codepush).

### Tailored for Expo

EAS Update is designed for Expo apps, making integration easy and workflows efficient. Use the website UIs to check app status and debug, especially for developers using EAS Build.

### Customizable Update Strategies

Apply updates through [`expo-updates` API](/versions/latest/sdk/updates) and [app config](/versions/latest/config/app/#updates) if the default behavior is not suitable for you. You’ll always have the upper hand in shaping the update process without compromising your users' experience.

## Get started

<BoxLink
title="Creating your first update"
Expand All @@ -34,21 +52,3 @@ Still using Classic Updates? We moved those docs to [the archive](/archive/class
description="View your teammate's changes with EAS Update."
href="/eas-update/develop-faster"
/>

<BoxLink
title="Deployment patterns"
description="Release processes that balance update safety and speed."
href="/eas-update/deployment-patterns"
/>

<BoxLink
title="Migrate from CodePush"
description="Transition a bare React Native project from CodePush."
href="/eas-update/codepush"
/>

<BoxLink
title="Debug"
description="When your app doesn't update as expected."
href="/eas-update/debug"
/>

0 comments on commit fccfbf3

Please sign in to comment.