liberusoftware / liberusoftware/documentation
MODULES.md section 9 puts a module- prefix in Composer package names that no published package uses
Nobody has claimed this yet.
- Dominant language
- No language data
- Stars
- 4
- Forks
- 0
- PR merge metrics
- No merged PRs in 30d
Description
architecture/MODULES.md §9 gives five presentation-adapter rows the form:
| Filament presentation adapter | liberusoftware/module-{independent-module-name}-filament |
That module- prefix is inside the Composer package name, and no published package follows it.
Evidence
All 40 packages installed by boilerplate-laravel drop the prefix. The pattern throughout the fleet is:
| Value | |
|---|---|
| Repository | module-blog-filament |
| Composer package | liberusoftware/blog-filament |
The prefix is a repository naming convention, not a package one. §9's other rows (Product capability, Shared core, Aggregate distribution) are all conformant with what the fleet actually publishes — only the five adapter rows are not.
Why it matters now
ecommerce-laravel is planning ~100 module packages. Following §9 literally would publish liberusoftware/module-ecommerce-cart-filament alongside an existing fleet of liberusoftware/blog-filament-shaped names, and the namespace column compounds it: §9 gives adapters two-segment namespaces, while a mechanical derivation from the package name gives three.
The deviation is recorded as ADR 0004 in ecommerce-laravel, which is why this issue exists — the ADR is a disagreement with §9, and a disagreement that lives only downstream becomes that repo's permanent problem.
Ask
Correct the five adapter rows to match what the fleet publishes, or state explicitly that the fleet's 40 packages are the ones that are wrong. Either answer is actionable; the current mismatch is not.
Found while auditing ecommerce-laravel against the standards.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Read architecture/MODULES.md §9 and compare its five presentation-adapter rows with the package names used by the 40 packages installed by boilerplate-laravel. Check the downstream ADR 0004 for the recorded disagreement. Done means the rows match the published naming convention, or the documentation explicitly states that the existing fleet is incorrect.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- laravel, php
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 68/100