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

nucleotide-count: Refactoring the description #913

Merged
merged 1 commit into from
Oct 1, 2017

Conversation

Dysp
Copy link
Contributor

@Dysp Dysp commented Sep 28, 2017

I have tried to be more precise, specific and accurate.
I am not sure what you are trying to accomplish with this description, so please let me know if you need any further help if the description expands.

I have tried to be more precise, specific and accurate.
I am not sure what you are trying to accomplish with this description, so please let me know if you need any further help if the description expands.
@Dysp Dysp changed the title Refactoring a readme Refactoring the readme/description Sep 28, 2017
@rpottsoh rpottsoh changed the title Refactoring the readme/description nucleotide-count: Refactoring the description Sep 28, 2017
@@ -1,25 +1,13 @@
Given a DNA string, compute how many times each nucleotide occurs in the string.
Given a single stranded DNA string, compute how many times each nucleotide occurs in the string.
Copy link
Member

@rpottsoh rpottsoh Sep 28, 2017

Choose a reason for hiding this comment

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

This sentence looks like it covers the point you raised in #902. The rest of the changes are interesting, and I don't think they are bad, but I am not sure that they are necessary. I am curious to read other peoples thoughts on this.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I made an effort not to bring in much new information. I simply structured the sentences and information already there to be more precise and accurate in accordance with biochemical discourse.
You may use my changes as you like :)

@rpottsoh
Copy link
Member

@Dysp thanks for creating this PR. The description.md is simply intended to describe the problem that the student will be trying to solve. This file becomes the basis of the readme.md that is delivered to the student via the CLI. This repo's readme.md has a short blurb about the description.md file. I am sure someone can point you to a better description of the file. Sometimes locating the best documentation for a given set of circumstances can be a little tricky.

@rpottsoh rpottsoh requested a review from Insti September 28, 2017 18:49
@Insti
Copy link
Contributor

Insti commented Sep 29, 2017

I, being a computer scientist rather than a biochemist, think these changes are an improvement to the description of DNA.

It contains the main information about the characters used to represent the nucleotides.

I might leave the bit about RNA out of this description as it is not at all relevant to the DNA nucleotide counting task.

The description of this problem has always been a bit informal.

There are other things that could be done to explain the task in programming terms, but that is out of scope for this PR which is about improving the biochemical accuracy of the description.

@rpottsoh
Copy link
Member

@Dysp I agree with @Insti.

Thanks for caring and taking the time to improve this exercise. 🥇

If you plan to make any of the other changes @Insti suggested just submit another commit to this PR with your changes. Give me a 👍 or post a comment if you are finished and I'll see that this PR is merged.

@Insti is right about this:

There are other things that could be done to explain the task in programming terms, but that is out of scope for this PR

If you want to pursue changes along this line, I would hold off until this PR is merged.

@rpottsoh
Copy link
Member

rpottsoh commented Oct 1, 2017

@Dysp I am going to go ahead and merge this PR. If you would like to to make any further changes please feel free to open a new PR. Thanks again for your efforts in improving the description for this exercise!

@rpottsoh rpottsoh merged commit d56ac50 into exercism:master Oct 1, 2017

RNA contains a slightly different set of nucleotides, but we don't care
about that for now.
In RNA the thymine is substituted with 'U' for uracil, while the remainder stay the same; A, U, C, G.
Copy link
Member

Choose a reason for hiding this comment

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

I don't think this information is necessary for this exercise, and including it will cause confusion. A student would naturally ask "Why did you tell me this? Why do I need to know this?"

Copy link
Contributor

Choose a reason for hiding this comment

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

Dealt with by #918

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.

4 participants