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

dominoes: improve description readability #972

Merged
merged 2 commits into from
Oct 27, 2017
Merged

Conversation

cmccandless
Copy link
Contributor

@cmccandless cmccandless commented Oct 25, 2017

Rework domino representation to avoid confusion with 2-digit numbers 23 vs. a domino (2, 3).

@@ -5,9 +5,9 @@ correct domino chain (the dots on one half of a stone match the dots on the
neighbouring half of an adjacent stone) and that dots on the halfs of the stones
which don't have a neighbour (the first and last stone) match each other.

For example given the stones `21`, `23` and `13` you should compute something
like `12 23 31` or `32 21 13` or `13 32 21` etc, where the first and last numbers are the same.
For example given the stones `(2, 1)`, `(2, 3)` and `(1, 3)` you should compute something
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would square brackets be more appropriate here?
And is "comma space" the best separator?

Possible alternatives:
[1, 1] [2,2] [3|3] [4:4]

@Insti
Copy link
Contributor

Insti commented Oct 26, 2017

Moving away from 2 digit numbers is an improvement 👍

@cmccandless
Copy link
Contributor Author

cmccandless commented Oct 26, 2017

@Insti I like [3|3].

"Tuple" format was chosen because many languages can implement this will naturally using tuples, so there representation is quite clear.

@Insti
Copy link
Contributor

Insti commented Oct 26, 2017

"Tuple" format was chosen because many languages can implement this will naturally using tuples, so there representation is quite clear.

That makes sense but we don't necessarily want the description to be prompting specific implementation details.

@cmccandless cmccandless merged commit 84ce49e into master Oct 27, 2017
@cmccandless cmccandless deleted the cmccandless-patch-1 branch October 27, 2017 14:40
cmccandless added a commit to cmccandless/python that referenced this pull request Oct 27, 2017
N-Parsons pushed a commit to exercism/python that referenced this pull request Nov 5, 2017
* add dominoes/README.md

* Add test cases and example solution for dominoes

* add dominoes to config.json

* dominoes: add check for name == "__main__"

* dominoes: update canonical data version and formatting fixes in README

* dominoes: update README to latest description

RE: exercism/problem-specifications#972
smalley pushed a commit to smalley/python that referenced this pull request Nov 12, 2017
* add dominoes/README.md

* Add test cases and example solution for dominoes

* add dominoes to config.json

* dominoes: add check for name == "__main__"

* dominoes: update canonical data version and formatting fixes in README

* dominoes: update README to latest description

RE: exercism/problem-specifications#972
smalley pushed a commit to smalley/python that referenced this pull request Nov 12, 2017
* add dominoes/README.md

* Add test cases and example solution for dominoes

* add dominoes to config.json

* dominoes: add check for name == "__main__"

* dominoes: update canonical data version and formatting fixes in README

* dominoes: update README to latest description

RE: exercism/problem-specifications#972
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants