Skip to content

Commit 16e4468

Browse files
fix: revise words on docs intro page (#9588)
Co-authored-by: Shahed Nasser <[email protected]>
1 parent 45df24f commit 16e4468

File tree

1 file changed

+14
-13
lines changed

1 file changed

+14
-13
lines changed

www/apps/book/app/learn/page.mdx

Lines changed: 14 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -8,14 +8,17 @@ export const metadata = {
88

99
# {pageNumber} Introduction
1010

11-
Medusa is a digital commerce platform with a built-in framework for customizations and integrations.
11+
Medusa is a digital commerce platform with a built-in framework for customization.
1212

13-
Medusa's framework includes two types of tools:
13+
Medusa ships with three main tools:
1414

15-
1. Modules that provide commerce functionalities, such as Product, Order, and Cart modules.
16-
2. Customization tools to build your business features, such as custom data models, business logic, flows, and endpoints.
15+
1. A suite of commerce modules that provide core commerce functionalities, such as tracking inventory, calculating cart totals, accepting payments, managing orders, and much more.
16+
2. A framework to build custom functionalities specific to your business, product, or industry. This includes tools for introducing custom API endpoints, business logic, and data models; building workflows and automations; and integrating with third-party services.
17+
3. A customizable admin dashboard for merchants to configure and operate their store.
1718

18-
With these tools, you save time you would spend with other platforms on maintaining and setting up your customizations. Instead, you rapidly build important features for your business.
19+
When you start Medusa the first time you get a fully fledged commerce platform with all the features you need to get off the ground.
20+
21+
However, unlike other platforms, Medusa is built with customization in mind. You don't need to build hacky workarounds that are difficult to maintain and scale. Instead, you can focus on building features that brings your business's vision to life.
1922

2023
---
2124

@@ -44,13 +47,11 @@ npx create-medusa-app@rc
4447

4548
---
4649

47-
## Who is Medusa for
50+
## Who should use Medusa
4851

49-
Medusa is for ambitious businesses and developers that are limited by traditional ecommerce solutions:
52+
Medusa is for businesses with unique requirements that other digital commerce platforms can't easily support. Businesses of any size can use Medusa, from small startups to large enterprises - all it takes is a developer to manage and deploy your project.
5053

51-
- You want rich commerce features that are customizable and flexible enough to support your business use case as if you built them from scratch.
52-
- You want your custom requirements built as an integral part of the commerce application’s features and architecture, rather than hacked into it.
53-
- You want to customize your commerce flows by integrating external services without data inconsistency and irregularity.
54+
Below are some stories from companies that use Medusa:
5455

5556
<CardList items={[
5657
{
@@ -95,14 +96,14 @@ Medusa is for ambitious businesses and developers that are limited by traditiona
9596

9697
## Who is this documentation for
9798

98-
This documentation is for TypeScript or JavaScript developers looking to master Medusa and build their commerce applications. By following this documentation, you’ll learn about Medusas concepts, from basic to advanced, with easy-to-follow examples to assist you along the way.
99+
This documentation is for developers looking to master Medusa. The documentation is structured to gradually introduce Medusa's concepts, from basic to advanced, with easy-to-follow examples to assist you along the way.
99100

100-
By the end of this documentation, you’ll be an expert Medusa developer, leading teams using Medusa from the development till production.
101+
By the end of this documentation, you’ll be able to create custom commerce experiences that would otherwise take large engineering teams months to build.
101102

102103
### How to use the documentation
103104

104105
The documentation for Medusa v2 is split into the following sections:
105106

106-
1. The main documentation, which is the one you're currently viewing. It's highly recommended to follow all the chapters in this documentation before jumping into other documentation sections.
107+
1. The main documentation, which is the one you're currently viewing. It's recommended to follow the chapters in this documentation to understand the core concepts of Medusa and how to use them.
107108
2. The [Development Resources documentation](!resources!) provides guides and resources useful during your development, such as tools, API references, recipes, step-by-step guides and examples, and more.
108109
3. The [Store](!api!/store) and [Admin](!api!/admin) API references provide a reference to the Medusa application's endpoints and instructions related to authentication, parameter types, and more.

0 commit comments

Comments
 (0)