Update wording of 01-Getting-Started #643
Conversation
Hi! I'm learning Javascript and have found these tutorials to be incredibly helpful. While the articles are very clear, some of the wording isn't natural to me as an English speaker. I was hoping I could contribute to this project by updating the wording of the articles to read more like natural English. If you like these edits, let me know and I'll make my way through the rest of the articles as I read them. Thanks for creating this.
|
|
|
Thank you! |
|
|
||
| In this aspect, JavaScript is very different from another language called [Java](https://en.wikipedia.org/wiki/Java_(programming_language)). | ||
|
|
||
| ```smart header="Why <u>Java</u>Script?" | ||
| When JavaScript was created, it initially had another name: "LiveScript". But Java language was very popular at that time, so it was decided that positioning a new language as a "younger brother" of Java would help. |
There was a problem hiding this comment.
Not everyone knows that Java is a language.
There was a problem hiding this comment.
Please leave it as is or add "programming language".
There was a problem hiding this comment.
OK! We just need to add a "The" in there-->
| When JavaScript was created, it initially had another name: "LiveScript". But Java language was very popular at that time, so it was decided that positioning a new language as a "younger brother" of Java would help. | |
| When JavaScript was created, it initially had another name: "LiveScript". But the Java programming language was very popular at that time, so it was decided that positioning a new language as a "younger brother" of Java would help. |
| @@ -86,14 +86,13 @@ There are at least *three* great things about JavaScript: | |||
| ```compare | |||
| + Full integration with HTML/CSS. | |||
| + Simple things are done simply. | |||
| + Supported by all major browsers and enabled by default. | |||
| + Support by all major browsers and enabled by default. | |||
There was a problem hiding this comment.
The reason I made this change was to help the last line match the structure of the first one. The changing structure of these bullets makes them a little bit harder to follow.
If each bullet starts with a verb, they'll flow more naturally together. A quick test would be to put "Javascript is..." in front of each of these to see if they form a well-structured sentence. If each of these passes the test, we've gotten closer to the parallel structure described in the link above:
- Fully integrated with HTML/CSS.
- Supported by all major browsers and enabled by default.
- Able to do simple things in simple ways.
Let me know if you would like me to make these changes or keep as is.
|
Hi @iliakan, I responded to your comments! |
|
You're a native speaker, is that correct? |
|
I am, but I do not want to make changes you don't agree with. This is a great tutorial--I want to help the wording flow more naturally in English without changing the content. |
|
Okay, then I assume you're sure of the new wording ;) |
|
Sounds good. I'll try to submit a pull request for a chapter a day. Thanks again for creating this tutorial. |
Hi! I'm learning Javascript and have found these tutorials to be incredibly helpful. While the articles are very clear, some of the wording isn't natural to me as an English speaker. I was hoping I could contribute to this project by updating the wording of the articles to read more like natural English. If you like these edits, let me know and I'll make my way through the rest of the articles as I read them. Thanks for creating this.