* initial changes
* redesign the sidebar + nav drawer
* changes to sidebar items
* finish up sidebar redesign
* support new sidebar in resources
* general fixes
* integrate in ui
* support api reference
* refactor
* integrate in user guide
* docs: fix build errors
* fix user guide build
* more refactoring
* added banner
* added bottom logo + icon
* fix up sidebar
* fix up paddings
* fix shadow bottom
* docs: add table of content (#8445)
* add toc types
* implement toc functionality
* finished toc redesign
* redesigned table of content
* mobile fixes
* truncate text in toc
* mobile fixes
* merge fixes
* implement redesign
* add hide sidebar
* add menu action item
* finish up hide sidebar design
* implement redesign in resources
* integrate in api reference
* integrate changes in ui
* fixes to api reference scrolling
* fix build error
* fix build errors
* fixes
* fixes to sidebar
* general fixes
* fix active category not closing
* fix long titles
- Fix the merger configuration that adds the correct slug / sidebar labels
- Add an overview page for the workflows reference.
- Fixes to components and build scripts
- 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
This PR includes documentation that preps for v2 docs (but doesn't introduce new docs).
_Note: The number of file changes in the PR is due to find-and-replace within the `references` which is unavoidable. Let me know if I should move it to another PR._
## Changes
- Change Medusa version in base OAS used for v2.
- Fix to docblock generator related to not catching all path parameters.
- Added typedoc plugin that generates ER Diagrams, which will be used specifically for data model references in commerce modules.
- Changed OAS tool to output references in `www/apps/api-reference/specs-v2` directory when the `--v2` option is used.
- Added a version switcher to the API reference to switch between V1 and V2. This switcher is enabled by an environment variable, so it won't be visible/usable at the moment.
- Upgraded docusaurus to v3.0.1
- Added new Vale rules to ensure correct spelling of Medusa Admin and module names.
- Added new components to the `docs-ui` package that will be used in future documentation changes.
- Added anchor links to items in parameter components
- Added sectionTitle prop in markdown theme
Note: Due to the second point, the change requires generating references to see the anchor links, which would result in a big diff in this PR. Instead, next time the references are generated for a release, this feature will available for use.