docs: add setup details to contribution guidelines (#12619)

This commit is contained in:
Shahed Nasser
2025-05-26 19:30:17 +03:00
committed by GitHub
parent e7cf2219b6
commit 730cac0ed2
2 changed files with 33 additions and 2 deletions
@@ -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
+1 -1
View File
@@ -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",