Skip to content

Docs: Set up PR preview docs#41

Closed
repl6669 wants to merge 8 commits into1.0from
docs/set-up-pr-preview-docs
Closed

Docs: Set up PR preview docs#41
repl6669 wants to merge 8 commits into1.0from
docs/set-up-pr-preview-docs

Conversation

@repl6669
Copy link
Contributor

@repl6669 repl6669 commented Mar 20, 2025

Summary by CodeRabbit

  • Documentation

    • Updated the site’s branding with a new title, description, and hero content to reflect the "Dystore" identity and focus on a collection of ecommerce packages.
    • Refined the content detailing the package ecosystem.
    • Removed several outdated documentation pages, including those related to authentication, products, orders, and more, to streamline user guidance.
    • Adjusted the overall structure and formatting of documentation for improved clarity.
  • Chores

    • Cleaned up obsolete configuration and documentation files to enhance overall maintainability.
    • Updated deployment configurations to reflect changes in documentation structure.

@coderabbitai
Copy link

coderabbitai bot commented Mar 20, 2025

Warning

Rate limit exceeded

@repl6669 has exceeded the limit for the number of commits or files that can be reviewed per hour. Please wait 2 minutes and 58 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

📥 Commits

Reviewing files that changed from the base of the PR and between 1a8922e and c002069.

⛔ Files ignored due to path filters (1)
  • docs/package-lock.json is excluded by !**/package-lock.json
📒 Files selected for processing (2)
  • .github/workflows/deploy-docs-preview.yaml (1 hunks)
  • .github/workflows/deploy-docs.yaml (1 hunks)

Walkthrough

This pull request updates the documentation by rebranding content from Lunar API to Dystore. The configuration files in the main docs have been modified to reflect the new title, description, and GitHub link, while the hero section in the landing page has been updated accordingly. Additionally, a significant number of documentation files and related configuration/theme files under the packages/api/docs directory have been removed. These removals include API extension guides, reference documents, installation instructions, and auxiliary resource files.

Changes

File(s) Change Summary
docs/.vitepress/config.mts, docs/index.md Rebranded documentation: updated title, description, tagline, and GitHub link to reflect Dystore.
packages/api/docs/.gitignore, packages/api/docs/.vitepress/config.mts, packages/api/docs/.vitepress/theme/index.ts, packages/api/docs/.vitepress/theme/style.css Removed VitePress configuration and custom theme files.
packages/api/docs/extending/*.md Removed all API extension documentation files (controllers, examples, models, overview, policies, queries, resources, route groups, schemas).
packages/api/docs/{configuration,index,initial-setup,installation,upgrade-guide,overview}.md, packages/api/docs/more/*.md Removed general API guides and configuration documentation, including additional resources and compatibility notes.
packages/api/docs/reference/*.md Removed comprehensive API reference documentation for entities such as addresses, attributes, auth, brands, carts, collections, customers, orders, payment-options, products, and users.
packages/api/docs/package.json Deleted documentation package management file and associated dependency scripts.
.github/workflows/deploy-docs-preview.yaml Updated umbrella-dir parameter for documentation deployment.
docs/overview.md Modified bullet point formatting and updated title.

Poem

I’m but a little rabbit in a field of code,
Hopping over changes on a brand new road.
Lunar’s shadow fades as Dystore comes to play,
Old files bid farewell, making room for a new day.
With each deleted line, my ears begin to quiver—
A joyful beat in the docs that makes my heart shiver!
🐰🌟


🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Generate unit testing code for this file.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai generate unit testing code for this file.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and generate unit testing code.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@repl6669 repl6669 changed the title Docs: Set up pr preview docs Docs: Set up PR preview docs Mar 20, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Mar 20, 2025

Documentation preview

✅ View preview at: https://dystcz.github.io/dystore/previews/pr-41/

Built to branch `` at 2025-03-20 09:56 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 6c988a3 and 06195e4.

📒 Files selected for processing (1)
  • .github/workflows/deploy-docs-preview.yaml (1 hunks)
🧰 Additional context used
🪛 actionlint (1.7.4)
.github/workflows/deploy-docs-preview.yaml

56-56: property "preview-step" is not defined in object type {}

(expression)


59-59: property "preview-step" is not defined in object type {}

(expression)


67-67: property "preview-step" is not defined in object type {}

(expression)


70-70: property "preview-step" is not defined in object type {}

(expression)

🔇 Additional comments (5)
.github/workflows/deploy-docs-preview.yaml (5)

26-26: Clarify Tilde Marker Usage

Line 26 shows a tilde marker without an accompanying code change. If this is intentional (e.g., for formatting), please confirm; otherwise, consider removing it for clarity.


33-33: Clarify Tilde Marker Usage

Line 33 contains a tilde marker with no apparent code change. If this marker isn’t needed, it might be best to remove it to avoid unnecessary noise in the diff.


39-39: Clarify Tilde Marker Usage

Line 39 shows a tilde marker that does not seem to indicate any code modification. If unintentional, please remove it.


40-43: Updated VitePress Build Command

The build command now uses
npm run docs:build --base=/docs/previews/pr-${{ github.event.number }}
which reflects the updated directory structure for documentation previews. This change aligns with the rebranding effort—please ensure consistent updates across related documentation and configuration.


53-53: Clarify Tilde Marker Usage

Line 53 contains a tilde marker that does not seem tied to a content change. If it is not purposeful, please remove it to avoid confusion.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

♻️ Duplicate comments (1)
.github/workflows/deploy-docs-preview.yaml (1)

50-60: ⚠️ Potential issue

Missing Step ID for Deploy Preview
The "Deploy preview" step does not specify an id, yet later steps reference its outputs via steps.preview-step. Without an id: preview-step, these output references will fail. Please add an id: preview-step to this step.

Suggested change:

-      - name: Deploy preview
-        uses: rossjrw/pr-preview-action@v1
-        with:
-          preview-branch: pages-pr-previews
-          source-dir: docs/.vitepress/dist
-          umbrella-dir: docs/previews
-          action: auto
-          token: ${{ secrets.PREVIEW_TOKEN }}
+      - name: Deploy preview
+        id: preview-step
+        uses: rossjrw/pr-preview-action@v1
+        with:
+          preview-branch: pages-pr-previews
+          source-dir: docs/.vitepress/dist
+          umbrella-dir: docs/previews
+          action: auto
+          token: ${{ secrets.PREVIEW_TOKEN }}
🧰 Tools
🪛 actionlint (1.7.4)

60-60: unexpected token "[" while parsing variable access, function call, null, bool, int, float or string. expecting "IDENT", "(", "INTEGER", "FLOAT", "STRING"

(expression)

🧹 Nitpick comments (5)
.github/workflows/deploy-docs.yaml (5)

26-30: Minor Formatting in Checkout Step
An extra newline appears at line 30 after the checkout configuration. This change is purely stylistic and can improve readability, provided it aligns with the team’s formatting guidelines.


31-37: Minor Formatting in Setup Node Step
A blank line is added at line 37 following the caching configuration. While it doesn’t affect functionality, ensure that the spacing is consistently applied across all steps in the workflow.


38-40: Spacing after Setup Pages
An extra newline at line 40 helps visually separate the "Setup Pages" step. This stylistic change is fine, but if your team follows strict YAML formatting guidelines, you might want to standardize spacing.


41-43: Spacing in Install Dependencies Step
The newline added at line 43 after the npm ci command does not impact execution. It is a minor formatting adjustment—please verify that similar spacing is applied throughout the workflow for consistency.


44-46: Spacing in Build Step
Line 46 shows an extra newline after the build command (npm run docs:build --base=/docs/). This formatting change is cosmetic; ensure that the overall file formatting is consistent with your team’s style.

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 06195e4 and c298934.

📒 Files selected for processing (2)
  • .github/workflows/deploy-docs-preview.yaml (1 hunks)
  • .github/workflows/deploy-docs.yaml (1 hunks)
🧰 Additional context used
🪛 actionlint (1.7.4)
.github/workflows/deploy-docs-preview.yaml

60-60: unexpected token "[" while parsing variable access, function call, null, bool, int, float or string. expecting "IDENT", "(", "INTEGER", "FLOAT", "STRING"

(expression)


63-63: property "preview-step" is not defined in object type {}

(expression)


71-71: property "preview-step" is not defined in object type {}

(expression)


74-74: property "preview-step" is not defined in object type {}

(expression)

⏰ Context from checks skipped due to timeout of 90000ms (4)
  • GitHub Check: api - PHP 8.4 - L12
  • GitHub Check: api - PHP 8.4 - L11
  • GitHub Check: api - PHP 8.3 - L11
  • GitHub Check: api - PHP 8.3 - L12
🔇 Additional comments (5)
.github/workflows/deploy-docs.yaml (1)

47-64: Overall Workflow Configuration Review
The updated workflow for deploying documentation is well structured. Using actions like actions/setup-node@v4, actions/configure-pages@v4, and actions/upload-pages-artifact@v3 is appropriate for your documentation deployment process.

Additionally, double-check that the branch trigger (branches: ["1.0"]) aligns with your intended GitHub Pages deployment strategy for PR preview docs.

.github/workflows/deploy-docs-preview.yaml (4)

40-43: Update VitePress Build Command
The build command now uses --base=/docs/, aligning with the revised deployment URL structure. Please verify that this new base path is consistent with all related configurations.


44-49: Artifact Upload Step Added
The new "Upload artifact" step ensures that the generated documentation from ./docs/.vitepress/dist is properly captured for deployment. Confirm that the artifact path is correct and accessible by the subsequent deployment processes.


61-70: Output References in "Comment on deploy" Step
This step references outputs such as steps.preview-step.outputs.preview-url and steps.preview-step.outputs.action-start-time. These references will be unresolved unless the "Deploy preview" step is updated with an id: preview-step (as noted above).

🧰 Tools
🪛 actionlint (1.7.4)

63-63: property "preview-step" is not defined in object type {}

(expression)


71-80: Output References in "Comment on removal" Step
Similar to the previous step, this step relies on steps.preview-step.outputs.deployment-action and steps.preview-step.outputs.action-start-time. Ensure that the "Deploy preview" step includes id: preview-step so these outputs become available.

🧰 Tools
🪛 actionlint (1.7.4)

71-71: property "preview-step" is not defined in object type {}

(expression)


74-74: property "preview-step" is not defined in object type {}

(expression)

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Nitpick comments (1)
.github/workflows/deploy-docs-preview.yaml (1)

49-59: Deploy preview step configuration update.
The addition of id: preview-step effectively addresses previous output reference issues, and the introduction of new parameters such as preview-branch and pages-base-url (set to dystcz.github.io/dystore) aligns with the recent rebranding efforts. One nitpick: verify whether the pages-base-url should include a protocol (e.g., https://) depending on downstream requirements.

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 5e832b9 and 1a8922e.

📒 Files selected for processing (1)
  • .github/workflows/deploy-docs-preview.yaml (1 hunks)
⏰ Context from checks skipped due to timeout of 90000ms (4)
  • GitHub Check: api - PHP 8.4 - L12
  • GitHub Check: api - PHP 8.4 - L11
  • GitHub Check: api - PHP 8.3 - L12
  • GitHub Check: api - PHP 8.3 - L11
🔇 Additional comments (7)
.github/workflows/deploy-docs-preview.yaml (7)

26-26: Minor whitespace/formatting update in Checkout step.
The change at line 26 appears to be a non-substantive adjustment (likely whitespace or newline).


29-33: Node setup configuration verification.
The cache-dependency-path is set to "./docs/package-lock.json", which should correctly cache your npm dependencies. Verify that this path remains valid relative to the working directory defined in the workflow defaults.


38-39: Minor formatting update in Install dependencies step.
The slight modification on line 39 appears non‐substantive. Please ensure that the conditional (if: github.event.action != 'closed') and the dependency installation via npm ci still work as expected.


40-43: Updated VitePress build command.
The build command now uses npm run docs:build --base=/, reflecting a simplified base URL that aligns with the new deployment structure. Please confirm that this change does not negatively affect relative resource links in your generated documentation.


44-48: New Upload artifact step added.
This step uploads artifacts from ./docs/.vitepress/dist, ensuring that the generated documentation is preserved for deployment. Double-check that the build process indeed creates the expected output in this directory.


61-71: New Comment on deploy step.
This step utilizes the marocchino/sticky-pull-request-comment@v2 action to post useful deployment details (including the preview URL, branch information, and the action start time) when the preview is successfully deployed. The conditional check ensures comments are only posted under the correct circumstances.


72-81: New Comment on removal step.
This added step effectively communicates to stakeholders when a documentation preview has been removed due to the pull request being closed. The clarity of the message and reliance on output variables from the preview-step look good.

fix action

update action

update action

update action

update action

update action

update action

update action

update action

update action

update action

update action

update workflow

update action

update

update

update action

update action

update action

update actions

update

update

update

update

comment out
@repl6669 repl6669 force-pushed the docs/set-up-pr-preview-docs branch from 2f808f7 to c002069 Compare March 20, 2025 10:05
@repl6669 repl6669 closed this Mar 20, 2025
@repl6669 repl6669 deleted the docs/set-up-pr-preview-docs branch March 20, 2025 10:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant