Skip to content

Tracking: Syncing exercises to problem specifications #628

Description

@mk-mxp

Using configlet sync at the time of writing is a wall of warnings. These are things to sync. I will extract one issue for each exercise, but that takes some more time.

To sync an exercise with problem specifications, take these steps:

  • Run bin/configlet sync -u -e <slug> --yes --docs --filepaths --metadata --tests include (updates the Markdown files and maybe tests.toml)
  • Drop strict types comments from test file and example code (these are useless)
    • Keep the comment in the students stub file. And the directive itself shall be in all PHP files, too.
  • Add and sync test meta data to tests (uuid in DocBlocks / #TestDox())
  • Add exercise to bin/auto-sync.txt to keep it in sync (keep the file alphabetically sorted)
  • Decide on adding / adjusting / ordering test cases to match current problem specs
  • If you wish, add your GitHub handle to the list of contributors in exercises/practice/<slug>/.meta/config.json

Do not redesign the student's interface or add test cases that would invalidate existing community solutions. These are extra tasks, which should be discussed in advance.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions