Align storefront README with the other components - #6515
Conversation
The storefront README was carried over unchanged from the solidus_storefront repository merged in solidusio#6468, so it still presented the component as a standalone gem: a hero image and CI/codecov badges pointing at the old repository (the workflow badge even linked to a literal <WORKFLOW_FILE> placeholder), a compatibility section describing version branches of the old repo, a CI strategy section describing pipelines that no longer exist, and Security/About sections that the sibling components leave to the main README. Rewrite it following the structure of the other component READMEs (backend, admin, api): a short description, installation, and testing and development sections. The compatibility section now reflects how the installer actually resolves templates since the monorepo merge: released Solidus versions apply the templates from their corresponding vX.Y branch, prereleases from main. The development section bullets now match what docs/development.md actually covers. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Now that the storefront lives in the main Solidus repository, the project-wide LICENSE.md applies to it like every other component. The storefront is not packaged as a gem, so nothing ships or references this file, and keeping a separate Nebulab-copyrighted license around would only create confusion about which terms apply. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## main #6515 +/- ##
=======================================
Coverage 92.02% 92.02%
=======================================
Files 1035 1035
Lines 21125 21125
=======================================
Hits 19440 19440
Misses 1685 1685 ☔ View full report in Codecov by Harness. 🚀 New features to boost your workflow:
|
jarednorman
left a comment
There was a problem hiding this comment.
Thanks Alberto! One small nit and one thing I wanted to double check.
| ``` | ||
|
|
||
| That will create a new Solidus application with SolidusStorefront as its | ||
| That will create a new Solidus application with the starter frontend as its |
There was a problem hiding this comment.
Much of this still references the starter frontend. Instead, should say "the storefront" or "this storefront".
| @@ -32,112 +27,58 @@ MANIFEST | |||
| bin/rails generate solidus:install --frontend=starter | |||
There was a problem hiding this comment.
@AlistairNorman did we leave the flag/identifier as --frontend=starter?
There was a problem hiding this comment.
Yes, the identifier is still starter: the installer registers it as the default frontend in install_generator.rb, so the command here is correct.
The component is called the storefront now that it lives in the monorepo, so the README and the development doc shouldn't keep calling it the Starter Frontend. The only remaining "starter" reference is the literal --frontend=starter installer flag. Addresses review comment: https://github.com/solidusio/solidus/pull/6515/files#r3582450121 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
Thanks @kennyadsl! |
Summary
The storefront README came over verbatim from the
solidus_storefrontrepository when it was merged into the monorepo in #6468, so it still described the component as a standalone gem. Several links were broken or stale: the CI badge pointed at the old repository's workflows (with a literal<WORKFLOW_FILE>placeholder in the URL), the codecov badge tracked the old repo, and the compatibility and CI strategy sections described version branches and scheduled pipelines of a repository that is no longer where this code lives.This rewrites the README following the structure of the other component READMEs (backend, admin, api): a short description of what the component is, followed by installation, testing, and development sections. The compatibility section now describes how the installer actually resolves templates since the monorepo merge — released Solidus versions apply the templates from their corresponding
vX.Ybranch, prereleases frommain. The hero image, badges, and the Security/About sections are gone, since the sibling components leave that kind of project-level content to the main README. The development section bullets now match whatdocs/development.mdactually covers (running the sandbox and Docker development).It also removes
storefront/LICENSE: the storefront is not packaged as a gem, so nothing ships or references that file, and the project-wideLICENSE.mdapplies to it like every other component.🤖 Generated with Claude Code