Commit Graph
100 Commits
Author SHA1 Message Date
Shahed Nasser 70d48a91b3 docs: added storefront guide on prices with taxes (#8326) 2024-07-30 12:52:21 +03:00
Shahed Nasser 4bd77174f0 docs-util: fix knowledge base for functions (#8337) 2024-07-30 12:52:08 +03:00
Shahed Nasser ebaf0eb53a docs-util: rename docblock-generator to docs-generator (#8331)
* docs-util: rename docblock-generator to docs-generator

* change program name

* fix action
2024-07-29 16:04:33 +03:00
Shahed Nasser 7ad4e7b1c9 docs: added typedoc plugin to parse DML json files (#8300)
* docs-util: add docblock generator for models built with DML

* add missing turbo task

* docs-util: added typedoc plugin to parse dml json files
2024-07-29 14:19:04 +02:00
Shahed Nasser f9d86683e5 docs-util: update knowledge base of docblock-generator (#8323)
* docs: update knowledge base for functions and filters

* fix build error
2024-07-29 12:34:25 +03:00
Shahed Nasser a171057fd7 chore(types): add a note about adding ssl_mode option to database URLs (#8324)
* chore(types): add a note about adding `ssl_mode` option to database URLs

* small fix
2024-07-29 12:34:10 +03:00
Shahed Nasser d127abbcda docs-util: add docblock generator for models built with DML (#8296)
* docs-util: add docblock generator for models built with DML

* add missing turbo task
2024-07-29 10:11:39 +02:00
Shahed Nasser a4eab3f37a docs: added a service factory reference (#8292)
Added a service factory reference of the generated methods and how to use them.

Since the types in the codebase are a bit complex, a generated reference won't provide a valuable result.

Instead, this reference is created manually and aims to cover common use cases, providing examples for them.

Closes DOCS-844
2024-07-26 14:40:56 +00:00
Shahed Nasser f3274a7c5b docs: update deployment guides for storefront and admin (#8279)
Update the vercel deployment guides for next.js storefront and admin

Closes DOCS-840 and DOCS-841
2024-07-26 07:21:31 +00:00
Shahed Nasser 157fa3c80f docs: remove js client and medusa react references (#8270) 2024-07-26 10:11:37 +03:00
Shahed Nasser ebd290b531 docs: added guide on how to get product variant prices (#8282) 2024-07-26 10:09:41 +03:00
Shahed Nasser eb64ae75a6 docs: update middlewares to use defineMiddlewares (#8283) 2024-07-25 17:14:06 +02:00
Shahed Nasser 0c682b92c4 docs: updates to Medusa server deployment guides (#8268)
* updated railway deployment docs

* general updates and fixes
2024-07-25 09:55:22 +03:00
Shahed Nasser 6ed1181057 chore(types): update workerMode tsdocs (#8269) 2024-07-25 09:55:12 +03:00
Shahed Nasser 0a482e972f docs: added a section to introduction on using docs (#8257)
Add a section to the introduction page explaining the different sections of the V2 docs and how / when to use them.
2024-07-24 14:16:33 +00:00
Shahed Nasser b615645952 docs: fix package names of event bus modules (#8262)
* docs: fix package names of event bus modules

* fix in config
2024-07-24 17:07:41 +03:00
Shahed Nasser ccc99b48a0 docs: add 404 page (#8260) 2024-07-24 17:07:30 +03:00
Shahed Nasser 7a0941e997 docs: fix rewrites in sub-projects to prevent loop on 404 page (#8255) 2024-07-24 17:06:54 +03:00
Shahed Nasser 774d04da48 docs: fix information related to link directions (#8236)
* docs: fix keys passed to remoteLink.create and remoteLink.dismiss

* updated hello module name + clarified note

* added details about module link directions

* fix lint errors
2024-07-24 09:16:01 +02:00
Shahed Nasser a02f6cbca6 fix(types,order): fixes to order module's service and data models (#8247)
* fix(types,order): fixes to order module's service and data models

* revert change for createLineItemAdjustments

* add missing context parameter
2024-07-24 09:00:21 +02:00
Shahed Nasser 97f64a5cfe docs: fix note about how method names are generated (#8240)
* docs: fix note about how method names are generated

* small fix
2024-07-23 18:28:34 +03:00
Shahed Nasser 55b55b6a92 docs: updates and fixes to marketplace recipe example (#8150)
- Add compensation functions to workflows
- Use steps/workflows provided by Medusa instead of implementing the steps.
- Other fixes

PR in examples repo: https://github.com/medusajs/examples/pull/1 (might be easier to review)
2024-07-23 07:10:05 +00:00
Shahed Nasser a2d08eb635 docs: document links sync command (#8212)
* docs: document links sync command

* small wording fix

* sentence fix
2024-07-22 13:17:53 +03:00
Shahed Nasser ac21f35b2c fix(create-medusa-app): run links sync during setup (#8215)
Run `links sync` command along with running migrations
2024-07-22 10:09:33 +00:00
Shahed Nasser f435c6c7f6 docs: fix fulfillment provider option name (#8211)
Change `name` option of a fulfillment module provider to `id`.

Closes DOCS-830
2024-07-22 07:17:15 +00:00
Shahed Nasser 5def252e4b docs: add section on delete cascades (#8198)
* docs: add section on delete cascades

* small text fix
2024-07-21 21:21:36 +02:00
Shahed Nasser 2f56030101 docs: remove the requirement on is queryable (#8199) 2024-07-21 21:20:24 +02:00
Shahed Nasser 8daa4119f0 docs: add chapter on executing a workflow in another / in a step (#8163)
* docs: added chapter on using workflow in another

* remove container from object

* change to only mention executing a workflow in another

* pass missing highlight
2024-07-21 21:19:23 +02:00
Shahed Nasser 4ef268d829 fix(dashboard): fix header in create tax region form (#8197)
Use correct text for the header of the create tax region form.

Closes TRI-40
2024-07-19 13:19:02 +00:00
Shahed Nasser e0c0a86264 docs: added tax-inclusive conceptual guide and updates to storefront guide (#8186)
* docs: added tax-inclusive conceptual guide and updates to storefront guide

* sentence fix

* currency_code -> country_code
2024-07-18 19:03:37 +02:00
Shahed Nasser c900a104ce docs: fix auth routes in api reference (#8187) 2024-07-18 19:02:14 +02:00
Shahed Nasser 71ebcd1bd0 docs: fix module definition for providers (#8180) 2024-07-18 18:59:53 +02:00
Shahed Nasser 0dbb2c6691 docs: fix installation version of packages (#8177) 2024-07-18 13:04:29 +02:00
Shahed Nasser 76173afdfc docs: add update dependencies + release note details (#8159) 2024-07-18 08:57:11 +02:00
Shahed Nasser 0aac0f8bac docs: fix cross-project links to use base path in production (#8160) 2024-07-17 15:31:23 +03:00
Shahed Nasser b1964a0384 docs: remove type arguments passed to createWorkflow (#8161) 2024-07-17 13:19:51 +01:00
Shahed Nasser f73ca97ecc docs: rename data to event in subscribers across docs (#8149) 2024-07-16 17:12:05 +01:00
Shahed Nasser 4c004cd287 docs-util: add support for RequestWithContext in route-handler detection (#8141)
* docs-util: update OAS docblock-generator to support RequestWithContext

* support alias type arguments in case there are no type arguments
2024-07-16 13:06:19 +03:00
Shahed Nasser b38c0488be docs: remove imports from src in medusa-config.js (#8132)
Importing from `src` in `medusa-config.js` works in development, but would cause an error when running `build`/in production.

This removes from the docs all snippets that imports from the `src` directory. However, we should figure out a better way to handle re-using the module's name.
2024-07-15 16:00:54 +00:00
Shahed Nasser a74c900ab1 docs: add documentation for migration generate cli tool (#8128)
* docs: add documentation for migration generate cli tool

* changed migrations details in marketplace recipe

* added generated oas files to action

* vale + lint fixes

* don't import from src in medusa-config.js

* fix generate command in recipe

* fix module name
2024-07-15 17:46:10 +02:00
Shahed NasserandOli Juhl 5f2952bbf2 chore: fix docs issue template (#8068)
Co-authored-by: Oli Juhl <59018053+olivermrbl@users.noreply.github.com>
2024-07-14 18:04:11 +02:00
Shahed Nasser 85c15dbb25 fix(utils): error message when isQueryable is possibly not enabled. (#8096) 2024-07-11 18:54:43 +02:00
Shahed Nasser eebae37287 chore: add generated OAS and Typedoc output to automated PRs (#8054)
* chore: add generated OAS output to automated PR

* add typedoc json output
2024-07-11 18:17:37 +02:00
Shahed Nasser d8f58774df docs: highlight fixes (#8094) 2024-07-11 18:15:50 +02:00
Shahed Nasser 78f49286d0 docs: updated marketplace recipe + added example (#8061)
- Moved recipes into its own section of the learning resources
- Updated the marketplace recipe overview
- Added an example implementation of the marketplace recipe

Closes DOCS-791
2024-07-11 15:56:41 +00:00
Shahed Nasser 66acb3023e fix(migrations): small fix to the text (#8091)
Small fix to  the migrations text.
2024-07-11 13:16:11 +00:00
Shahed Nasser 368715ae37 docs: document when-then + migrations revert change (#8089)
- Add documentation around when-then and workflow conditions
- Change the CLI reference based on change in revert migrations command.
2024-07-11 12:30:50 +00:00
Shahed Nasser bb0303cd6a docs: improvements to module and data model documentation (#8062)
* docs: improvements to module and data model documentation

* add note about data model name casing
2024-07-11 13:53:40 +03:00
Shahed Nasser 02add3f0f5 docs: change event payload handling in subscribers (#8078) 2024-07-11 13:34:24 +03:00
Shahed Nasser a8df528c65 docs: add a need help button (#8069)
* docs: add a need help button

* change github issue link

* responsive fixes
2024-07-11 10:29:13 +03:00
Shahed Nasser d9b9a1df27 docs: add a section about constraints on step return value (#8036)
Rename the workflow constructor constraints document to include also step constraints and add a section about the allowed return value of a step.
2024-07-10 13:21:53 +00:00
Shahed Nasser 5c44ce6640 docs: updates to local file module provider documentation (#8030)
Updates to the local file provider module's documentation based on latest changes
2024-07-09 15:25:05 +00:00
Shahed Nasser 3e4a96a31c docs: update order module's conceptual guides (#7893)
* fixes + add return document

* update order conceptual guides

* resolve todo

* re-generate files map
2024-07-09 18:14:30 +03:00
Shahed Nasser 273529fde5 docs: added chapter on managing relationships (#8043) 2024-07-09 18:12:00 +03:00
Shahed Nasser 4c89f91caf docs: fix download button + other fixes (#8032)
- Fix text of download button
- Small fix to styling on small devies
- Fix mobile sidebar items using incorrect base url
2024-07-09 12:36:02 +00:00
Shahed Nasser 04886ea122 docs: rename property when defining a list link (#8017)
* docs: rename property when defining a list link

* added note about static directory

* remove note about static directory
2024-07-08 19:30:46 +02:00
Shahed Nasser 0c8730cdd3 docs: fix type in module path (#8011) 2024-07-08 18:15:29 +02:00
Shahed Nasser f1a860675c chore: update docs issue template (#8012)
Update the documentation issues template to ask for the Medusa version.
2024-07-08 09:02:57 +00:00
Shahed Nasser 3d6b1dc7ae docs: fix page crashing when using google translate (#8009) 2024-07-08 10:24:45 +02:00
Shahed Nasser d2c89e7071 fix(create-medusa-app): remove glob-related warnings (#7985)
On every new installation of `create-medusa-app`, you get a warning related to `glob`'s version.

Since we don't need `glob` anymore (it was used to remove boilerplate files), I've removed it along with its usage. This includes removing the `--no-boilerplate` option.
2024-07-08 08:24:10 +00:00
Shahed Nasser eafa3560ae chore(dashboard): text changes and fixes (#7925)
- Improvements to existing texts
- Add subtitles to sections where useful.
- Added the ability to edit the message shown in a list when no records are found + change the message where necessary
- Change documentation link to `https://docs.medusajs.com/v2`.
2024-07-05 12:14:10 +00:00
Shahed Nasser de0a9c14ab docs: fix pagination on mobile devices (#7968)
* docs: fix pagination on mobile devices

* fix algolia link
2024-07-05 12:40:42 +02:00
Shahed Nasser 36c1db7479 docs: fix edit button on resources homepage (#7967) 2024-07-05 10:52:43 +02:00
Shahed Nasser 22dbe34625 docs: fix URL of Algolia cron job (#7957) 2024-07-04 17:32:41 +00:00
Shahed Nasser 19c20ac747 docs: remove limitation on arrow functions in workflows (#7958) 2024-07-04 17:26:26 +00:00
Shahed Nasser 92dd855290 docs: restructure api-reference to allow base path (#7954) 2024-07-04 16:12:02 +00:00
Shahed Nasser 94e5feeb3d docs: fix rewrite to main docs (#7953) 2024-07-04 17:29:30 +02:00
Shahed Nasser 1acbcf612e docs: fix api-reference with proxy (#7952) 2024-07-04 17:10:48 +02:00
Shahed Nasser 20be64e799 docs-util: normalize primary key types in DML (#7941) 2024-07-04 17:35:24 +03:00
Shahed Nasser 525363630e docs: latest fixes (#7951) 2024-07-04 16:28:41 +02:00
Shahed Nasser 964927b597 docs: general fixes and improvements (#7918)
* docs improvements and changes

* updated module definition

* modules + dml changes

* fix build

* fix vale error

* fix lint errors

* fixes to stripe docs

* fix condition

* fix condition

* fix module defintion

* fix checkout

* disable UI action

* change oas preview action

* flatten provider module options

* fix lint errors

* add module link docs

* pr comments fixes

* fix vale error

* change node engine version

* links -> linkable

* add note about database name

* small fixes

* link fixes

* fix response code in api reference

* added migrations step
2024-07-04 17:26:03 +03:00
Shahed Nasser 9b1688944e fix: fix docs link in payment provider tsdocs (#7939)
* fix: fix docs link in payment provider tsdocs

* add a note
2024-07-04 11:09:29 +03:00
Shahed Nasser 6713d76db3 docs: prepare configuration (#7877)
* update configuration

* resolve todos + remove events guides

* disable v2 docs in v1 navbar

* remove v2 from v1 mobile sidebar

* resolve build errors

* fix build errors

* fix lint errors

* fix lint
2024-07-03 19:27:13 +03:00
Shahed Nasser 5aa62e59e4 chore: fix generate preview references action (#7901) 2024-07-03 14:10:19 +03:00
Shahed Nasser 0aeba83a66 docs: update scheduled jobs docs (#7905)
- Update scheduled jobs docs to support updated definition + remove coming soon notice
- Update scheduled jobs everywhere else they're used.
2024-07-02 09:41:15 +00:00
Shahed Nasser 6cb28eedf7 docs: document composite indices + primary key changes (#7902) 2024-07-02 12:34:44 +03:00
Shahed Nasser a8f2115157 docs: update pricing docs (#7895)
Update pricing docs following latest changes
2024-07-01 16:34:13 +00:00
Shahed Nasser 9b5f26adab chore: action to generate documentation references (#7888)
Added an action that triggers documentation actions generating references
2024-07-01 13:54:17 +00:00
Shahed Nasser dd864da4e0 generate references (#7882) 2024-07-01 16:02:36 +03:00
Shahed Nasser b9036eca1a docs: generate OAS for v2 (#7883) 2024-07-01 15:35:45 +03:00
Shahed Nasser 8fde57263f fix(create-medusa-app): remove preview links (#7884)
Remove temporary doc links set in `STORE_CORS` and `ADMIN_CORS`
2024-07-01 12:16:12 +00:00
Shahed Nasser 1f360a3245 docs-util: support models implemented with DML in typedoc custom plugins (#7847)
- Support generating reference for models implemented with DML
- Support resolving and generating mermaid diagram for relations

The Currency Module was used an example so its reference is generated to showcase the work of this PR.
2024-07-01 07:34:51 +00:00
Shahed Nasser b62f23ea00 docs: additions and improvements to modules and DML documentation (#7854)
* docs: additions and improvements to modules and DML documentation

* small wording fix
2024-07-01 10:26:40 +03:00
Shahed Nasser 72f7500c84 chore(docs): DML API Reference (#7863)
* added dml options

* added tsdocs + configurations
2024-07-01 10:21:56 +03:00
Shahed Nasser 9ded63cc62 chore: OAS and TSDoc fixes (#7864) 2024-07-01 10:21:34 +03:00
Shahed Nasser 1842cd33cf docs: rename provider module to module provider (#7869)
* docs: rename provider module to module provider

* fix vale rule

* vale fixes
2024-07-01 10:21:19 +03:00
Shahed Nasser 2833e3c4d0 fix(order): set correct change type for exchanges (#7870) 2024-07-01 10:20:58 +03:00
Shahed Nasser 6e65158af3 docs-util: Upgrade typedoc to 0.26 (#7853)
Upgrade typedoc to v0.26 + make changes based on the update

Note: This update produces an error when generating model references when the models use the `createPsqlIndexStatementHelper` decorator. As this isn't a breaking error, and as we'll move to DML in the future, it's not necessary to spend time on a fix.
2024-06-27 10:52:44 +00:00
Shahed Nasser 922fff4051 docs-util: fixes and improvements to OAS generator (#7731)
* fixed associated schema names

* move OAS method and summary descriptions to knowledge base

* refactoring and fixes

* detect default object value in delete responses
2024-06-26 11:54:09 +03:00
Shahed Nasser 0462cc5acf docs: updates to use DML and other changes (#7834)
- Change existing data model guides and add new ones for DML
- Change module's docs around service factory + remove guides that are now necessary
- Hide/remove all mentions of module relationships, or label them as coming soon.
- Change all data model creation snippets to use DML
- use `property` instead of `field` when referring to a data model's properties.
- Fix all snippets in commerce module guides to use new method suffix (no more main model methods)
- Rework recipes, removing/hiding a lot of sections as a lot of recipes are incomplete with the current state of DML.


### Other changes

- Highlight fixes in some guides
- Remove feature flags guide
- Fix code block styles when there are no line numbers.

### Upcoming changes in other PRs

- Re-generate commerce module references (for the updates in the method names)
- Ensure that the data model references are generated correctly for models using DML.
- (probably at a very later point) revisit recipes
2024-06-26 07:55:59 +00:00
Shahed Nasser 79d90fadc4 feat(utils): configure notification module by default (#7814)
Add the notification module to `defineConfig` and configure the local notification module.
2024-06-24 14:47:40 +00:00
Shahed Nasser c1db40b564 docs: added customer storefront guides (#7685)
* added customer guides

* fixes to sidebar

* remove old customer registration guide

* fix build error

* generate files

* run linter
2024-06-13 12:21:54 +03:00
Shahed Nasser 85d487d90b docs: added checkout storefront guides (#7678)
* add first guides

* added more guides

* finished payment + added stripe

* finished adding guides

* updated generated sidebar
2024-06-12 19:46:06 +02:00
Shahed Nasser 7e7e6e3311 chore: fix OAS circular dependencies (#7693) 2024-06-12 19:42:03 +02:00
Shahed Nasser ee6bdd0ab0 docs: add products storefront guides (#7645)
* add tips + regions pages

* docs: added storefront regions guide

* removed storefront tips chapter from book

* added product guides

* finished price guide

* add product category pages

* more categories pages

* finished category pages

* add collections guides

* add missing next.js comment

* use useRegion hook

* added missing link
2024-06-11 19:55:56 +02:00
Shahed Nasser f3bf8c73a3 docs: added cart storefront guides (#7662)
* docs: added cart storefront guides

* add context guides

* small fixes to the context
2024-06-11 11:56:37 +03:00
Shahed Nasser 2597990363 docs: fix details of selecting fields and relationships in api reference (#7642) 2024-06-09 15:19:51 +02:00
Shahed Nasser 46c5c5fe28 docs: added storefront regions guides (#7623) 2024-06-09 15:19:09 +02:00
Shahed Nasser 6946814944 docs: update recipes to be based on v2 (#7516) 2024-06-09 15:18:43 +02:00
Shahed Nasser e472aed00f docs: new + improved auth documentation pages (#7529)
* added and improved auth docs

* add prep to generates resources action

* add module options to sidebar

* fix broken link
2024-06-09 15:18:29 +02:00