From dde15c974b63251048e61c1bcd616e9a4c8b8d28 Mon Sep 17 00:00:00 2001 From: Peter Hauke <90506472+peterhauke@users.noreply.github.com> Date: Wed, 22 Jun 2022 18:53:30 +0200 Subject: [PATCH 1/3] Improve English language/correct grammar In the first paragraph, both of the following are correct: you'll need other resources. you'll need access to other sources. I propose the first version There is no hyphen in In-between, so you could write here: in between or between - but between is by far better. --- .../2-manuals-specifications/article.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/1-js/01-getting-started/2-manuals-specifications/article.md b/1-js/01-getting-started/2-manuals-specifications/article.md index f4b59268..952a77e6 100644 --- a/1-js/01-getting-started/2-manuals-specifications/article.md +++ b/1-js/01-getting-started/2-manuals-specifications/article.md @@ -1,25 +1,25 @@ # Manuals and specifications -This book is a *tutorial*. It aims to help you gradually learn the language. But once you're familiar with the basics, you'll need other sources. +This book is a *tutorial*. It aims to help you gradually learn the language. But once you're familiar with the basics, you'll need other resources. ## Specification [The ECMA-262 specification](https://www.ecma-international.org/publications/standards/Ecma-262.htm) contains the most in-depth, detailed and formalized information about JavaScript. It defines the language. -But being that formalized, it's difficult to understand at first. So if you need the most trustworthy source of information about the language details, the specification is the right place. But it's not for everyday use. +But being so formalized, it's difficult to understand at first. So if you need the most trustworthy source of information about the language details, the specification is the right place. But it's not for everyday use. -A new specification version is released every year. In-between these releases, the latest specification draft is at . +A new specification version is released every year. Between these releases, the latest specification draft is at . To read about new bleeding-edge features, including those that are "almost standard" (so-called "stage 3"), see proposals at . -Also, if you're developing for the browser, then there are other specifications covered in the [second part](info:browser-environment) of the tutorial. +Also, if you're developing for the browser, then there are other specifications covered in the [second part](info:browser-environment) of this tutorial. ## Manuals - **MDN (Mozilla) JavaScript Reference** is the main manual with examples and other information. It's great to get in-depth information about individual language functions, methods etc. - One can find it at . + You can find it at . Although, it's often best to use an internet search instead. Just use "MDN [term]" in the query, e.g. to search for `parseInt` function. @@ -27,11 +27,11 @@ Although, it's often best to use an internet search instead. Just use "MDN [term JavaScript is a developing language, new features get added regularly. -To see their support among browser-based and other engines, see: +To see how they are supported by browser-based and other engines, see: - - per-feature tables of support, e.g. to see which engines support modern cryptography functions: . - - a table with language features and engines that support those or don't support. -All these resources are useful in real-life development, as they contain valuable information about language details, their support etc. +All these resources are useful in real-life development, as they contain valuable information about language details, browser support, etc. -Please remember them (or this page) for the cases when you need in-depth information about a particular feature. +Please remember them (or this page) for when you need in-depth information about a particular feature. From a134d67e50bbfaecb842738ba19410c554549a61 Mon Sep 17 00:00:00 2001 From: Peter Hauke <90506472+peterhauke@users.noreply.github.com> Date: Wed, 22 Jun 2022 19:12:40 +0200 Subject: [PATCH 2/3] Fix one more missing word --- 1-js/01-getting-started/2-manuals-specifications/article.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/1-js/01-getting-started/2-manuals-specifications/article.md b/1-js/01-getting-started/2-manuals-specifications/article.md index 952a77e6..33202e37 100644 --- a/1-js/01-getting-started/2-manuals-specifications/article.md +++ b/1-js/01-getting-started/2-manuals-specifications/article.md @@ -21,7 +21,7 @@ Also, if you're developing for the browser, then there are other specifications You can find it at . -Although, it's often best to use an internet search instead. Just use "MDN [term]" in the query, e.g. to search for `parseInt` function. +Although, it's often best to use an internet search instead. Just use "MDN [term]" in the query, e.g. to search for the `parseInt` function. ## Compatibility tables From d399df7c6ffa75b3af226e3fda41998cbccedb5e Mon Sep 17 00:00:00 2001 From: Peter Hauke <90506472+peterhauke@users.noreply.github.com> Date: Sat, 2 Jul 2022 06:24:38 +0200 Subject: [PATCH 3/3] Remove language style improvements --- .../2-manuals-specifications/article.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/1-js/01-getting-started/2-manuals-specifications/article.md b/1-js/01-getting-started/2-manuals-specifications/article.md index 33202e37..519c1b1b 100644 --- a/1-js/01-getting-started/2-manuals-specifications/article.md +++ b/1-js/01-getting-started/2-manuals-specifications/article.md @@ -7,13 +7,13 @@ This book is a *tutorial*. It aims to help you gradually learn the language. But [The ECMA-262 specification](https://www.ecma-international.org/publications/standards/Ecma-262.htm) contains the most in-depth, detailed and formalized information about JavaScript. It defines the language. -But being so formalized, it's difficult to understand at first. So if you need the most trustworthy source of information about the language details, the specification is the right place. But it's not for everyday use. +But being that formalized, it's difficult to understand at first. So if you need the most trustworthy source of information about the language details, the specification is the right place. But it's not for everyday use. A new specification version is released every year. Between these releases, the latest specification draft is at . To read about new bleeding-edge features, including those that are "almost standard" (so-called "stage 3"), see proposals at . -Also, if you're developing for the browser, then there are other specifications covered in the [second part](info:browser-environment) of this tutorial. +Also, if you're developing for the browser, then there are other specifications covered in the [second part](info:browser-environment) of the tutorial. ## Manuals @@ -27,11 +27,11 @@ Although, it's often best to use an internet search instead. Just use "MDN [term JavaScript is a developing language, new features get added regularly. -To see how they are supported by browser-based and other engines, see: +To see their support among browser-based and other engines, see: - - per-feature tables of support, e.g. to see which engines support modern cryptography functions: . - - a table with language features and engines that support those or don't support. -All these resources are useful in real-life development, as they contain valuable information about language details, browser support, etc. +All these resources are useful in real-life development, as they contain valuable information about language details, their support, etc. -Please remember them (or this page) for when you need in-depth information about a particular feature. +Please remember them (or this page) for the cases when you need in-depth information about a particular feature.