René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"All exercise test files should reference canonical data version","articleBody":"Currently some of the test files reference `x-common//canonical-data.json` with a version number, and a few test files lack any such a reference. Additionally, `x-common` was recently renamed to `problem-specifications`, so references to `x-common` are inherently outdated and potentially confusing.\r\n\r\nHaving a consistent version string should help with maintenance, since a script can fairly easily be written to compare the version numbers in the test file and the canonical data, and manual checks for how up to date it is are similarly easy. It also makes it easier for exercism users to find and check the canonical data, and thus to be able to contribute any changes they think are necessary if they identify problems or additional tests that would be useful.\r\n\r\n### Suggested wording\r\n\r\nThe currently adopted form for the version string seems to be:\r\n``# test cases adapted from `x-common//canonical-data.json` @ version: 1.0.1``\r\n\r\nTo conform to PEP8, we should aim to limit the string to 79 characters, so I propose the following wording (75 chars):\r\n``# Tests adapted from `problem-specifications//canonical-data.json` @ v2.0.0``\r\n\r\nDoes anyone have any alternatives or suggestions for improvements to this wording?\r\n\r\n### How to proceed\r\n\r\nThere are a couple of options for how to go about updating the test files:\r\n1. Only update version strings when the tests are next updated, and update tests when the canonical data change.\r\n1. Systematically update each test file to match the most recent canonical data version (or verify that it's already up-to-date), and update the version strings in the process.\r\n\r\nOption 1 is obviously the less work-intensive one, but it would leave some inconsistency for quite a while. Option 2 is more work-intensive and should get everything up-to-date quicker, but it might burn people out a bit.","author":{"url":"https://github.com/N-Parsons","@type":"Person","name":"N-Parsons"},"datePublished":"2017-10-09T18:07:48.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":14},"url":"https://github.com/784/python/issues/784"}