docs: add setup details to contribution guidelines (#12619)
This commit is contained in:
1 parent
e7cf2219b6
commit
730cac0ed2
2 files changed
+33
-2
No files matched your search
@@ -1,3 +1,5 @@
|
|||||||
|
import { Prerequisites } from "docs-ui"
|
||||||
|
|
||||||
export const metadata = {
|
export const metadata = {
|
||||||
title: `Docs Contribution Guidelines`,
|
title: `Docs Contribution Guidelines`,
|
||||||
}
|
}
|
||||||
@@ -25,7 +27,7 @@ You can contribute to the Medusa documentation in the following ways:
|
|||||||
|
|
||||||
## Documentation Workspace
|
## 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:
|
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.
|
- `docs-ui` includes the shared React components between the different apps.
|
||||||
- `remark-rehype-plugins` includes Remark and Rehype plugins used by the documentation projects.
|
- `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
|
## 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/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/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/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/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/medusa-config/page.mdx": "2025-04-17T08:29:09.907Z",
|
||||||
"app/learn/configurations/ts-aliases/page.mdx": "2025-02-11T16:57:46.683Z",
|
"app/learn/configurations/ts-aliases/page.mdx": "2025-02-11T16:57:46.683Z",
|
||||||
|
|||||||
Reference in new issue
Block a user