Skip to content

Complete and correct the file structure page - #27

Merged
arhimede merged 2 commits into
mainfrom
complete-and-correct-file-structure-page
Sep 16, 2026
Merged

arhimede merged 2 commits into
mainfrom
complete-and-correct-file-structure-page

Conversation

@arhimede

Copy link
Copy Markdown
Member

The file structure page listed a directory that has never existed, described a script condition that is not in the code, named the wrong build tool, and omitted about half the repository.

  • Removed .laminas-ci. git ls-tree -r finds no such path at 1.0.0, 1.2.0 or 1.5.0.
  • clear-config-cache.php is not gated on development mode — the script unlinks the cache whatever the mode. Replaced that condition with the composer clear-config-cache shortcut that composer.json actually defines.
  • Documented bin/composer-post-install-script.php, which runs on post-update-cmd and puts the local configuration file in place. Three other pages tell the reader to edit that file, so the script explaining where it comes from was the one thing missing.
  • The public folder entries said the assets were generated by webpack. Vite replaced webpack in 1.3.0.
  • Added the parts of the repository the page skipped: a root files section (phpunit.xml, phpstan.neon, phpcs.xml, vite.config.js, package.json, CHANGELOG.md, SECURITY.md, renovate.json, .gitattributes, OSSMETADATA), the test folder, and src/App/assets — the source directory for the whole front-end build.

Every entry was checked against the application clone at release 1.5.0.

Note: the diagram at the top of the page is served from docs.dotkernel.org and still shows the old tree, so it needs regenerating separately.

Signed-off-by: arhimede <julian@dotkernel.com>
Signed-off-by: arhimede <julian@dotkernel.com>
@arhimede

Copy link
Copy Markdown
Member Author

Note: the diagram at the top of the page is served from docs.dotkernel.org and still shows the old tree, so it needs regenerating separately.

@bidi47 please take care of this image

@bidi47

bidi47 commented Sep 15, 2026

Copy link
Copy Markdown
Member

Note: the diagram at the top of the page is served from docs.dotkernel.org and still shows the old tree, so it needs regenerating separately.

@bidi47 please take care of this image

the new image is ready in dotkernel/dotkernel.github.io#45

@arhimede

Copy link
Copy Markdown
Member Author

Which means i need to update the image url in this pr

@bidi47

bidi47 commented Sep 15, 2026

Copy link
Copy Markdown
Member

Which means i need to update the image url in this pr

it's the same file (overwritten), so it should pe updated after the dotkernel.github.io PR is merged

@arhimede
arhimede merged commit e8b29a1 into main Sep 16, 2026
7 checks passed
@alexmerlin
alexmerlin deleted the complete-and-correct-file-structure-page branch September 16, 2026 11:48
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.

2 participants