Skip to content

docs: move to SolidBase#19

Merged
XiNiHa merged 1 commit into
mainfrom
solidbase
May 26, 2025
Merged

docs: move to SolidBase#19
XiNiHa merged 1 commit into
mainfrom
solidbase

Conversation

@XiNiHa

@XiNiHa XiNiHa commented Apr 3, 2025

Copy link
Copy Markdown
Owner

No description provided.

@changeset-bot

changeset-bot Bot commented Apr 3, 2025

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: be5b16a

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Apr 3, 2025

Copy link
Copy Markdown

Deploying solid-relay-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: be5b16a
Status:🚫  Build failed.

View logs

@pkg-pr-new

pkg-pr-new Bot commented Apr 3, 2025

Copy link
Copy Markdown

Open in StackBlitz

npm i https://pkg.pr.new/XiNiHa/solid-relay@19

commit: be5b16a

@codecov

codecov Bot commented Apr 3, 2025

Copy link
Copy Markdown

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 27.13%. Comparing base (76f4873) to head (be5b16a).
Report is 1 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main      #19   +/-   ##
=======================================
  Coverage   27.13%   27.13%           
=======================================
  Files          21       21           
  Lines        1360     1360           
  Branches       65       65           
=======================================
  Hits          369      369           
  Misses        991      991           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@XiNiHa XiNiHa force-pushed the solidbase branch 5 times, most recently from aff21d5 to ff4faaa Compare April 3, 2025 10:22
@XiNiHa

XiNiHa commented Apr 4, 2025

Copy link
Copy Markdown
Owner Author

/gemini review

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Code Review

The pull request migrates the documentation site to SolidBase. This involves significant changes to the project's configuration and structure, including updating dependencies, modifying the build process, and adopting a new theme. The changes appear well-organized and aim to improve the documentation experience. However, some aspects require closer scrutiny to ensure correctness and maintainability.

Summary of Findings

  • Documentation Updates: The README.md file was removed, and the documentation structure was significantly altered. It's crucial to ensure that the new documentation setup is complete and provides all necessary information for users.
  • Dependency Updates: The project's dependencies have been updated, including the removal of rspress and the addition of @kobalte/solidbase, @solidjs/start, and vinxi. It's important to verify that these changes are compatible and that all necessary configurations are in place.
  • Configuration Changes: The rspress.config.ts file was removed, and a new app.config.ts file was added. The tsconfig.json file was also modified. These changes need to be carefully reviewed to ensure that the project is configured correctly and that all necessary settings are in place.

Merge Readiness

The pull request introduces significant changes to the documentation site. While the changes appear well-organized, it's crucial to ensure that the new documentation setup is complete and provides all necessary information for users. I recommend addressing the review comments before merging. I am unable to approve this pull request, and users should have others review and approve this code before merging.

Comment thread docs/app.config.ts
Comment on lines +25 to +37
// @ts-ignore
github: "https://github.com/XiNiHa/solid-relay",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

Consider removing the @ts-ignore directive and properly typing the socialLinks object. This would improve type safety and prevent potential runtime errors.

Comment thread docs/app.config.ts
Comment on lines +65 to +99
...(await Promise.all(
["Functions", "Interfaces"].map(
async (section): Promise<SidebarItem> => {
const dir = section.toLowerCase();
const items = await fs.promises.readdir(
path.join(import.meta.dirname, "src/routes/api", dir),
);

return {
title: section,
collapsed: false,
items: items.map((item) => {
const name = path
.basename(item)
.replace(path.extname(item), "");
return {
title: name,
link: `/${dir}/${name}`,
};
}),
};
},
),
)),

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

This section dynamically generates sidebar items for the API reference. Ensure that the fs.promises.readdir call handles potential errors (e.g., directory not found) gracefully to prevent the application from crashing. Consider adding a try...catch block.


### controls?

> `readonly` `optional` **controls**: `OpaqueReference`\<\{ `dispose`: `DisposeFn`; `environment`: `Environment`; `getNetworkError`: () => `null` \| `Error`; `isDisposed`: () => `boolean`; `releaseQuery`: () => `void`; `source`: `undefined` \| `RelayObservable`\<`GraphQLResponse`\>; \}, `undefined`\>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

The controls property description mentions RelayObservable but the type definition uses Observable. Ensure that the description accurately reflects the type.

Comment thread docs/src/routes/index.mdx
Comment on lines +10 to +11
- text: Quick Start
link: /guide

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

The link in the 'Quick Start' action is now /guide instead of /guide/. Verify that this change is intentional and that the link correctly points to the getting started guide.

@XiNiHa XiNiHa force-pushed the solidbase branch 6 times, most recently from d12f7f6 to 014e3d6 Compare April 9, 2025 06:36
@XiNiHa XiNiHa force-pushed the solidbase branch 6 times, most recently from 6519107 to 6969759 Compare May 26, 2025 05:50
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented May 26, 2025

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Updated (UTC)
✅ Deployment successful!
View logs
solid-relay be5b16a May 26 2025, 05:56 AM

@XiNiHa XiNiHa merged commit 13cde64 into main May 26, 2025
5 of 6 checks passed
@XiNiHa XiNiHa deleted the solidbase branch May 26, 2025 05:57
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