Question
Answer (68)
Issue Type
Documentation
Summary
Add a dedicated support matrix page or section that clearly documents which PHP, Laravel, and Filament versions are supported during the 1.x series.
Problem / Context
The compatibility story is validated in CI, but it is not presented in a single, user-friendly place in the docs. Users evaluating the package should be able to confirm supported version combinations quickly.
Proposed Solution
Add a support matrix to the docs site and link to it from the main documentation flow. The page should describe the supported versions and note that the matrix may evolve in future major releases.
Acceptance Criteria
- [ ] A docs page or section lists supported PHP, Laravel, and Filament versions for
1.x. - [ ] The information aligns with the tested combinations in CI.
- [ ] The support matrix is linked from the main docs navigation or overview page.
Implementation Notes
Use .github/workflows/run-tests.yml as the source of truth. The content can live in a dedicated docs page or be added to an existing docs page if that reads better.
Testing Notes
Build the docs site locally and verify that the published support matrix matches the CI matrix.
Additional Context
This is a strong trust signal for a newly stable 1.x package.
Answer:
To address the issue of publishing a 1.x support matrix for PHP, Laravel, and Filament, follow the proposed solution below:
- Create a dedicated support matrix page or section in the documentation site.
- List the supported versions of PHP, Laravel, and Filament for the 1.x series on the page.
- Note that the matrix may evolve in future major releases.
- Ensure that the information on the support matrix aligns with the tested combinations in the continuous integration (CI) system.
- Link the support matrix from the main documentation navigation or overview page for easy access.
Acceptance Criteria:
- [ ] A docs page or section lists supported PHP, Laravel, and Filament versions for 1.x.
- [ ] The information aligns with the tested combinations in CI.
- [ ] The support matrix is linked from the main docs navigation or overview page.
Implementation Notes:
You can use the .github/workflows/run-tests.yml file as the source of truth for the supported version combinations. The content can live in a dedicated docs page or be added to an existing docs page, depending on which option reads better.
Testing Notes:
To ensure that the published support matrix matches the CI matrix, build the docs site locally and verify the content.
Additional Context:
Providing a support matrix is an essential trust signal for a newly stable 1.x package, making it easier for users to evaluate and confirm the compatibility of their chosen versions.