12_findTheOldest: Clarify test descriptions #340
Merged
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Because
The tests for 12_findTheOldest lead to frequent confusion because of the disconnect between the English sentence in the test description, and the expected outcome of the test.
The confusion comes from expectations of how we use English. Culturally in English speaking countries (i can't speak for others), we are not used to referring to anyone who is already dead as the oldest. When 2 people are dead, and someone is alive and 17 years old, that person is generally thought about as "the oldest", because oldest is reserved for the living.
Culturally, the second test: 'finds the person with the greatest age if someone is still living' would be considered ambiguous English. That's the test that causes the most confusion.
Additionally, the test passing arguments are too similar to the function itself.
The
findTheOldest()
pass condition is 'finds the oldest person!'To make this less ambiguous and less tautological, I suggest changing
'the oldest person'
to
the person with the greatest age
I believe this helps with some of the common tendency to infer that the person who is living is older than the person who is dead, no matter how old the dead person was when they were alive.
This PR
oldest person
toperson with the greatest age
.Issue
Closes #XXXXX
Additional Information
Link to a recent discussion where many people expressed confusion while solving this exercise.
Here are some more examples of people getting caught up on understanding the wording.
Pull Request Requirements
location of change: brief description of change
format, e.g.01_helloWorld: Update test cases
Because
section summarizes the reason for this PRThis PR
section has a bullet point list describing the changes in this PRIssue
sectionsolutions
branch, I have created another PR (and linked it to this PR).