Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

grammar, usage, punctuation edits, Part 1, sections 3.1 - 4.6 #138

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

Merged
iliakan merged 1 commit into javascript-tutorial:master from jmbothe:master
Aug 16, 2017

Conversation

@jmbothe
Copy link
Contributor

@jmbothe jmbothe commented Aug 14, 2017

No description provided.

Copy link
Member

iliakan commented Aug 15, 2017

@jmbothe What you think about this PR: https://github.com/iliakan/javascript-tutorial-en/pull/139/files, is it a correct change?

Copy link
Member

@iliakan iliakan left a comment

Choose a reason for hiding this comment

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

Superb, just please take a look at few comments.

While choosing a name try to use the most abstract word. Like `obj`, `data`, `value`, `item`, `elem` and so on.

- **The ideal name for a variable is `data`.** Use it everywhere where you can. Indeed, every variable holds *data*, right?
- **The ideal name for a variable is `data`.** Use it everywhere you can. Indeed, every variable holds *data*, right?
Copy link
Member

@iliakan iliakan Aug 15, 2017
edited
Loading

Choose a reason for hiding this comment

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

"Use it everywhere you can" - does that really sound good here?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@iliakan This change is grammatically correct. The extra "where" is redundant. And to answer "does it sound good here": yes, this sounds like natural English. It fits your conversational style well, I think :)

Copy link
Member

Choose a reason for hiding this comment

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

Ok great.

## Summary

One of signs of a good developer is his comments. Good comments allow to maintain the code well, return to it after a long delay and use features more effectively.
One sign of a good developer is his comments. Good comments allowus to maintain the code well, return to it after a long delay and use features more effectively.
Copy link
Member

@iliakan iliakan Aug 15, 2017
edited
Loading

Choose a reason for hiding this comment

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

guess, a typo (space lost), fix please.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@iliakan Sorry! this is my mistake. I will fix it, and I will be more careful next time :)

- Follow some of them -- and your code will become full of surprises.
- Follow many of them -- and your code will become truly yours, no one would want to change it.
- Follow all -- and your code will become a valuable lesson for young developers looking for enlightment.
- Follow some of them, and your code will become full of surprises.
Copy link
Member

@iliakan iliakan Aug 15, 2017
edited
Loading

Choose a reason for hiding this comment

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

Are you sure that a dash is wrong here? The phrases look better with it. Are the English rules really so strict that there must be no dash, or maybe a kind of "author punctuation" is possible?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@iliakan This change is correct punctuation, but as far as whether the sentence look better with dashes: that is a stylistic choice for you to make. But considering punctuation only, the "Follow..." clauses are dependent clauses of the rest of the sentence. In English when a dependent clause precedes an independent clause, we usually place a comma between them, although the comma is optional. It is considered incorrect to separate a dependent clause and an independent clause with a dash.

Copy link
Member

@iliakan iliakan Aug 16, 2017
edited
Loading

Choose a reason for hiding this comment

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

Okay, I'd just like to introduce a pause there. Using a comma is all right? Should I accept the current variant?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Yes, a comma is good for introducing a pause here. It represent logical separation of the clauses, and a natural pause in reading/speaking rhythm.

@iliakan iliakan merged commit 3b25bc5 into javascript-tutorial:master Aug 16, 2017
athena0304 pushed a commit to athena0304/javascript-tutorial-en that referenced this pull request Aug 21, 2018
...tutorial#138)
* 翻译完成
* fix
* Update task.md
* Update task.md
* Update solution.md
* Update task.md
* Update article.md
* Update article.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@iliakan iliakan iliakan requested changes

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

AltStyle によって変換されたページ (->オリジナル) /