From 78e95432f42311032f4db21fffe62c2a08b37b16 Mon Sep 17 00:00:00 2001 From: Phil <4522927+p2635@users.noreply.github.com> Date: Sat, 28 Jan 2023 01:15:54 +0000 Subject: [PATCH 1/8] Cut down unnecessary words --- .../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 3fa2433363..d2ad05a4b1 100644 --- a/1-js/01-getting-started/2-manuals-specifications/article.md +++ b/1-js/01-getting-started/2-manuals-specifications/article.md @@ -1,19 +1,19 @@ # 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 resources. +This book is a *tutorial*. It aims to help you gradually learn the language. 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. +Being that formalized, it's difficult to understand at first. 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 the tutorial. +If you're developing for the browser, there are other specifications covered in the [second part](info:browser-environment) of the tutorial. ## Manuals @@ -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 the `parseInt` function. +It's often best to use an internet search with "MDN [term]" in the query, e.g. to search for the `parseInt` function. ## Compatibility tables @@ -34,4 +34,4 @@ To see their support among browser-based and other engines, see: 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 the cases when you need in-depth information about a particular feature. +Please remember them (or this page) when you need in-depth information about a particular feature. From 990957e156886ac259e5f29e87994324104b6970 Mon Sep 17 00:00:00 2001 From: Phil <4522927+p2635@users.noreply.github.com> Date: Sat, 28 Jan 2023 12:22:13 +0000 Subject: [PATCH 2/8] Restructure into a list --- .../2-manuals-specifications/article.md | 15 ++++++--------- 1 file changed, 6 insertions(+), 9 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 d2ad05a4b1..28b26ee132 100644 --- a/1-js/01-getting-started/2-manuals-specifications/article.md +++ b/1-js/01-getting-started/2-manuals-specifications/article.md @@ -1,19 +1,16 @@ # Manuals and specifications -This book is a *tutorial*. It aims to help you gradually learn the language. Once you're familiar with the basics, you'll need other resources. +This book is a *tutorial* to help you gradually learn the language. 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. +The ECMA-262 specification defines the JavaScript language. The formal document is not for everyday use as it's difficult to understand at first. If you need the most trustworthy source of information about the language details, the specification is the right place. -Being that formalized, it's difficult to understand at first. 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 . - -If you're developing for the browser, there are other specifications covered in the [second part](info:browser-environment) of the tutorial. +- [The ECMA-262 specification](https://www.ecma-international.org/publications/standards/Ecma-262.htm) contains the most in-depth, detailed and formalized information. +- 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 . +- If you're developing for the browser, there are other specifications covered in the [second part](info:browser-environment) of the tutorial. ## Manuals From 56ff8199dd3f072dc3280d4e2979d6e401f98c39 Mon Sep 17 00:00:00 2001 From: Phil <4522927+p2635@users.noreply.github.com> Date: Sat, 28 Jan 2023 12:23:18 +0000 Subject: [PATCH 3/8] Moved sentence to the top --- 1-js/01-getting-started/2-manuals-specifications/article.md | 4 ++-- 1 file changed, 2 insertions(+), 2 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 28b26ee132..12f91bf81d 100644 --- a/1-js/01-getting-started/2-manuals-specifications/article.md +++ b/1-js/01-getting-started/2-manuals-specifications/article.md @@ -5,10 +5,10 @@ This book is a *tutorial* to help you gradually learn the language. Once you're ## Specification -The ECMA-262 specification defines the JavaScript language. The formal document is not for everyday use as it's difficult to understand at first. If you need the most trustworthy source of information about the language details, the specification is the right place. +The ECMA-262 specification defines the JavaScript language. The formal document is not for everyday use as it's difficult to understand at first. If you need the most trustworthy source of information about the language details, the specification is the right place. A new specification version is released every year. - [The ECMA-262 specification](https://www.ecma-international.org/publications/standards/Ecma-262.htm) contains the most in-depth, detailed and formalized information. -- A new specification version is released every year. Between these releases, the latest specification draft is at . +- 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 . - If you're developing for the browser, there are other specifications covered in the [second part](info:browser-environment) of the tutorial. From 5d7e094e73650d36b08249c59c4132265d5d9d80 Mon Sep 17 00:00:00 2001 From: Phil <4522927+p2635@users.noreply.github.com> Date: Sat, 28 Jan 2023 12:26:48 +0000 Subject: [PATCH 4/8] Second bullet point - make parallel --- 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 12f91bf81d..3abb715026 100644 --- a/1-js/01-getting-started/2-manuals-specifications/article.md +++ b/1-js/01-getting-started/2-manuals-specifications/article.md @@ -8,7 +8,7 @@ This book is a *tutorial* to help you gradually learn the language. Once you're The ECMA-262 specification defines the JavaScript language. The formal document is not for everyday use as it's difficult to understand at first. If you need the most trustworthy source of information about the language details, the specification is the right place. A new specification version is released every year. - [The ECMA-262 specification](https://www.ecma-international.org/publications/standards/Ecma-262.htm) contains the most in-depth, detailed and formalized information. -- Between these releases, the latest specification draft is at . +- [The latest specification draft](https://tc39.es/ecma262/) is discussed and reviewed between specification releases. - To read about new bleeding-edge features, including those that are "almost standard" (so-called "stage 3"), see proposals at . - If you're developing for the browser, there are other specifications covered in the [second part](info:browser-environment) of the tutorial. From 84bb02f3cdac47228ee60c9bd012a6e1e615fd63 Mon Sep 17 00:00:00 2001 From: Phil <4522927+p2635@users.noreply.github.com> Date: Sat, 28 Jan 2023 12:30:26 +0000 Subject: [PATCH 5/8] Third bullet point - make parallel --- 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 3abb715026..64f71b1bad 100644 --- a/1-js/01-getting-started/2-manuals-specifications/article.md +++ b/1-js/01-getting-started/2-manuals-specifications/article.md @@ -9,7 +9,7 @@ The ECMA-262 specification defines the JavaScript language. The formal document - [The ECMA-262 specification](https://www.ecma-international.org/publications/standards/Ecma-262.htm) contains the most in-depth, detailed and formalized information. - [The latest specification draft](https://tc39.es/ecma262/) is discussed and reviewed between specification releases. -- To read about new bleeding-edge features, including those that are "almost standard" (so-called "stage 3"), see proposals at . +- [Proposals about new bleeding-edge features](https://github.com/tc39/proposals), including those that are "almost standard" (so-called "stage 3"). - If you're developing for the browser, there are other specifications covered in the [second part](info:browser-environment) of the tutorial. ## Manuals From 8bd95cad373969d0ec1a5a5926722acbccb8e64f Mon Sep 17 00:00:00 2001 From: Phil <4522927+p2635@users.noreply.github.com> Date: Sat, 28 Jan 2023 12:33:25 +0000 Subject: [PATCH 6/8] Fourth bullet point - make parallel --- 1-js/01-getting-started/2-manuals-specifications/article.md | 4 ++-- 1 file changed, 2 insertions(+), 2 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 64f71b1bad..9b9918ad50 100644 --- a/1-js/01-getting-started/2-manuals-specifications/article.md +++ b/1-js/01-getting-started/2-manuals-specifications/article.md @@ -9,8 +9,8 @@ The ECMA-262 specification defines the JavaScript language. The formal document - [The ECMA-262 specification](https://www.ecma-international.org/publications/standards/Ecma-262.htm) contains the most in-depth, detailed and formalized information. - [The latest specification draft](https://tc39.es/ecma262/) is discussed and reviewed between specification releases. -- [Proposals about new bleeding-edge features](https://github.com/tc39/proposals), including those that are "almost standard" (so-called "stage 3"). -- If you're developing for the browser, there are other specifications covered in the [second part](info:browser-environment) of the tutorial. +- [Proposals for new bleeding-edge features](https://github.com/tc39/proposals), including those that are "almost standard" (so-called "stage 3"). +- [Part 2 - Browser: Document, Events, Interfaces](info:browser-environment) covers other specifications if you're developing for the browser. ## Manuals From 4c228698c44654c6c1a22322495fb0c6d7974e0f Mon Sep 17 00:00:00 2001 From: Phil <4522927+p2635@users.noreply.github.com> Date: Sat, 28 Jan 2023 12:35:09 +0000 Subject: [PATCH 7/8] Move link --- 1-js/01-getting-started/2-manuals-specifications/article.md | 4 +--- 1 file changed, 1 insertion(+), 3 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 9b9918ad50..86427c2e0b 100644 --- a/1-js/01-getting-started/2-manuals-specifications/article.md +++ b/1-js/01-getting-started/2-manuals-specifications/article.md @@ -14,9 +14,7 @@ The ECMA-262 specification defines the JavaScript language. The formal document ## 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. - - You can find it at . +- [MDN (Mozilla) JavaScript Reference](https://developer.mozilla.org/en-US/docs/Web/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. It's often best to use an internet search with "MDN [term]" in the query, e.g. to search for the `parseInt` function. From 5d9a973540ef5d25e5f7a85f1f3a70f9ba7e197e Mon Sep 17 00:00:00 2001 From: Phil <4522927+p2635@users.noreply.github.com> Date: Sat, 28 Jan 2023 12:42:15 +0000 Subject: [PATCH 8/8] Remove unnecessary words / Simplify --- .../2-manuals-specifications/article.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 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 86427c2e0b..f6f93b5fff 100644 --- a/1-js/01-getting-started/2-manuals-specifications/article.md +++ b/1-js/01-getting-started/2-manuals-specifications/article.md @@ -7,22 +7,22 @@ This book is a *tutorial* to help you gradually learn the language. Once you're The ECMA-262 specification defines the JavaScript language. The formal document is not for everyday use as it's difficult to understand at first. If you need the most trustworthy source of information about the language details, the specification is the right place. A new specification version is released every year. -- [The ECMA-262 specification](https://www.ecma-international.org/publications/standards/Ecma-262.htm) contains the most in-depth, detailed and formalized information. -- [The latest specification draft](https://tc39.es/ecma262/) is discussed and reviewed between specification releases. -- [Proposals for new bleeding-edge features](https://github.com/tc39/proposals), including those that are "almost standard" (so-called "stage 3"). +- [ECMA-262 specification](https://www.ecma-international.org/publications/standards/Ecma-262.htm) contains the most in-depth, detailed and formalized information. +- [Latest draft](https://tc39.es/ecma262/) is discussed and reviewed between specification releases. +- [Proposals for bleeding-edge features](https://github.com/tc39/proposals), including those that are "almost standard" (so-called "stage 3"). - [Part 2 - Browser: Document, Events, Interfaces](info:browser-environment) covers other specifications if you're developing for the browser. ## Manuals -- [MDN (Mozilla) JavaScript Reference](https://developer.mozilla.org/en-US/docs/Web/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. +- [MDN (Mozilla) JavaScript Reference](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference) is the main manual with examples and in-depth information about individual language functions, methods etc. -It's often best to use an internet search with "MDN [term]" in the query, e.g. to search for the `parseInt` function. +It's often best to Google "MDN [term]" in your query, e.g. to search for the `parseInt` function. ## Compatibility tables JavaScript is a developing language, new features get added regularly. -To see their support among browser-based and other engines, see: +To see browser and engine support, 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.