docs: align the documentation with Thelia 3.0.0-beta3 - #30
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Brings the documentation in line with what 3.0.0-beta3 ships.
Install
You must either configure a "public_key" or a "secret_key". The page names the file to check afterwards.bin/installbuilds the front-office assets itself (importmap:install, thentailwind:build), so the manualnpmstep for the front theme is gone from every install page. Thedefault-twigback-office keeps its Webpack Encore build, because itsdist/is not shipped, and that is stated where the step is asked for.3.0.0-beta3.install-referencelists the kernel phase as it really runs, including the JWT key pair and the asset build, and says why the two asset commands run last and when they are skipped.Front-office theme
Creating a themedocuments the catch-all/{_view}controller that renders category, product, content and folder pages, why its priority is negative and whyadminandapiare excluded. Thethelia/front-modulepackage is no longer involved.VIRTUAL_PRODUCT_ORDER_DOWNLOAD_RESPONSEand never reads the file, and a shop with no virtual product module gets a 404 rather than a 500.config/views.yamlis documented, with the rules the core applies: optional file, nearest declaration wins, a request naming an internal view gets a 404 while a controller rendering the same template is unaffected.importmap.php,assets/,asset()andimportmap(),tailwind:build --watch, and no<assets>tag intemplate.xml.symfony/ux-twig-componentis explained, along with the extension that suppliesprovide()andinject()when the 2.x line is resolved.Two 3.0 pages that the previous commits changed only under
docs/are brought back in sync.Not covered
The Flexy pages still describe the component layout, the Twig namespaces and the SEO helpers of the previous theme. That drift predates this pull request and needs its own pass.