Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Discussion: Improve PHP track docs for PHPUnit / composer #864

Open
mk-mxp opened this issue Nov 17, 2024 · 1 comment
Open

Discussion: Improve PHP track docs for PHPUnit / composer #864

mk-mxp opened this issue Nov 17, 2024 · 1 comment

Comments

@mk-mxp
Copy link
Contributor

mk-mxp commented Nov 17, 2024

I think our track docs make things too complicated for new students.

Right after the required installation of PHP we have a short paragraph about installing composer. For PHPUnit we then describe composer as the main means of installation. Using the PHPUnit PHAR is last and "optional". But composer is not required to solve Exercism exercises.

The easiest way to use PHPUnit for Exercism is downloading the PHAR. So we should provide tutorial-style instructions on that first. Also we should check, that exercism test runs the PHAR when using these instructions.

In a more optional looking paragraph we may then describe and explain composer and PHPUnit installation using it. There is a nice short description of composer and installation we may use to improve the composer introduction and installation. We should also mention that composer is wide-spread in the PHP ecosystem.

@tomasnorre
Copy link
Contributor

That sounds like a good approach.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants