docs: add setup details to contribution guidelines (#12619)
This commit is contained in:
@@ -1,3 +1,5 @@
|
||||
import { Prerequisites } from "docs-ui"
|
||||
|
||||
export const metadata = {
|
||||
title: `Docs Contribution Guidelines`,
|
||||
}
|
||||
@@ -25,7 +27,7 @@ You can contribute to the Medusa documentation in the following ways:
|
||||
|
||||
## Documentation Workspace
|
||||
|
||||
Medusa's documentation projects are all part of the documentation yarn workspace, which you can find in the [medusa repository](https://github.com/medusajs/medusa) under the `www` directory.
|
||||
Medusa's documentation projects are all part of the documentation `yarn` workspace, which you can find in the [medusa repository](https://github.com/medusajs/medusa) under the `www` directory.
|
||||
|
||||
The workspace has the following two directories:
|
||||
|
||||
@@ -38,6 +40,35 @@ The workspace has the following two directories:
|
||||
- `docs-ui` includes the shared React components between the different apps.
|
||||
- `remark-rehype-plugins` includes Remark and Rehype plugins used by the documentation projects.
|
||||
|
||||
### Setup the Documentation Workspace
|
||||
|
||||
<Prerequisites
|
||||
items={[
|
||||
{
|
||||
text: "Node.js v20+",
|
||||
link: "https://nodejs.org/en/download"
|
||||
},
|
||||
{
|
||||
text: "Yarn v3+",
|
||||
link: "https://v3.yarnpkg.com/getting-started/install"
|
||||
}
|
||||
]}
|
||||
/>
|
||||
|
||||
In the `www` directory, run the following command to install the dependencies:
|
||||
|
||||
```bash
|
||||
yarn install
|
||||
```
|
||||
|
||||
Then, run the following command to build packages under the `www/packages` directory:
|
||||
|
||||
```bash
|
||||
yarn build
|
||||
```
|
||||
|
||||
After that, you can change into the directory of any documentation project under the `www/apps` directory and run the `dev` command to start the development server.
|
||||
|
||||
---
|
||||
|
||||
## Documentation Content
|
||||
|
||||
@@ -110,7 +110,7 @@ export const generatedEditDates = {
|
||||
"app/learn/fundamentals/api-routes/parse-body/page.mdx": "2025-04-17T08:29:10.145Z",
|
||||
"app/learn/fundamentals/admin/routing/page.mdx": "2025-02-24T09:50:37.495Z",
|
||||
"app/learn/resources/contribution-guidelines/admin-translations/page.mdx": "2025-02-11T16:57:46.726Z",
|
||||
"app/learn/resources/contribution-guidelines/docs/page.mdx": "2025-03-06T09:32:26.010Z",
|
||||
"app/learn/resources/contribution-guidelines/docs/page.mdx": "2025-05-26T15:55:02.974Z",
|
||||
"app/learn/resources/usage/page.mdx": "2025-02-26T13:35:34.824Z",
|
||||
"app/learn/configurations/medusa-config/page.mdx": "2025-04-17T08:29:09.907Z",
|
||||
"app/learn/configurations/ts-aliases/page.mdx": "2025-02-11T16:57:46.683Z",
|
||||
|
||||
Reference in New Issue
Block a user