These descriptions will be used when a list of the available scripts is requested on the command-line using the composer list or composer run -l commands.
These descriptions also help document the different scripts for the maintainers of the composer.json file.
Context
composer.json
file and improve usability of scriptsSummary
This PR can be summarized in the following changelog entry:
composer.json
file and improve usability of scriptsRelevant technical choices:
Composer: normalize the file
Well, mostly (scripts are not alphabetized, but still grouped by task).
Note: this is done as a one-time only action. The normalize script will not be run in CI to enforce normalization.
Style has been standardized to
--indent-style=tab --indent-size=1
.Ref: https://github.com/ergebnis/composer-normalize
Composer: add script descriptions
These descriptions will be used when a list of the available scripts is requested on the command-line using the
composer list
orcomposer run -l
commands.These descriptions also help document the different scripts for the maintainers of the
composer.json
file.Ref: https://getcomposer.org/doc/articles/scripts.md#custom-descriptions-
Test instructions
Test instructions for the acceptance test before the PR gets merged
This PR can be acceptance tested by following these steps: