Streamline `contribution` commands

Open
#1,066 1 comment 0 reactions 1 assignee View on GitHub

@homersimpsons is already working on this.

Since Nov 7, 2026.

Assessment

This issue has not been assessed yet.

Description

x:knowledge/advanced x:module/generator x:status/claimed x:type/coding

This is a plan to stramline our contribution/ commands.

  1. Create a structured command directory (#1067)
  2. Move checkDeprecatedExercises.php as a command (#1067)
  3. Move contribution/generator as a command (currently a fully fledged symfony application) (#1068)
  4. Move exercises/concept/bootstrap.sh as a command (or delete it if it is a duplicate of 3.) (#1068)
  5. Make a test generator from templates (#674)
  6. Make contribution commands more discoverable (documentation in README) (#1071)

Going further:

  1. test generator: Run in CI to check files outputs are consistent with template
  2. test generator: Run in CI on a monthly basis to re-generate the tests (capturing their upstream updates)
  3. test generator: Write more tests
  4. test generator: convert more exercises
  5. exercise generator: make it generate template file
  6. automatically fetch configlet
  7. kickstart documentation, ideally a ./main.php exercism:init <slug> would give enough information and generate enough files
  8. maintain documentation, ideally a ./main.php exercism:sync would give enough information and generate enough files (kind of linked to point 2)
Dominant language
PHP
Stars
167
Forks
151
Avg merge
2d 6h
Merged PRs (30d)
8

Getting set up

Open in Codespaces

Starts the project's dev container in your browser, under your own GitHub account.

  • No Dockerfile or Docker Compose file
  • No pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from exercism/php

All issues in exercism/php

Similar issues

More PHP issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.