From f0bd1f2c0c1ad4019998a4c04a26b13d7e5fd496 Mon Sep 17 00:00:00 2001 From: Stefan Stojanovic Date: Tue, 13 Jul 2021 12:27:29 +0200 Subject: [PATCH 1/2] Update intro-bdi.md minor grammar improvements --- web/html/citation-elements/intro-bdi.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/web/html/citation-elements/intro-bdi.md b/web/html/citation-elements/intro-bdi.md index f2b99a4ba1..11e7615124 100755 --- a/web/html/citation-elements/intro-bdi.md +++ b/web/html/citation-elements/intro-bdi.md @@ -27,11 +27,11 @@ revisionQuestion: ## Content -The HTML ``, or the **Bidirectional Isolation** element, is used to isolate a span of text that might be formatted in a different direction than other text - typically working with languages from different languages whose direction is unknown. +The ``, or the **Bidirectional Isolation** element, is used to isolate a span of text that might be formatted in a different direction than other text, typically working with languages whose direction is unknown. -For instance, you can use this on a text that is in English (written left-right), to present it in Arabic (written right-left). The '[user agent](https://developer.mozilla.org/en-US/docs/Glossary/user_agent)' detects that the text should be rendered differently and adjusts accordingly. +For instance, you can use this on a text in English (written left-right) to present it in Arabic (written right-left). The '[user agent](https://developer.mozilla.org/en-US/docs/Glossary/user_agent)' detects that the text should be rendered differently and adjusts accordingly. -If you don't use the `` element when working with alphanumeric numbers and Arabic text can you see how the code doesn't display as you would expect?: +If you don't use the `` element when working with alphanumeric numbers and Arabic text, can you see how the code doesn't display as you would expect?: ```html

From 10e77a6ee97976977a152d5da03562656365834a Mon Sep 17 00:00:00 2001 From: Stefan-Stojanovic Date: Tue, 13 Jul 2021 13:43:54 +0200 Subject: [PATCH 2/2] remove wordiness and other grammar improvements --- web/html/citation-elements/address.md | 2 +- web/html/citation-elements/blockquotes.md | 7 ++--- web/html/citation-elements/intro-bdo.md | 2 +- web/html/citation-elements/intro-cite.md | 28 +++++++++---------- web/html/citation-elements/intro-q.md | 2 +- web/html/computer-code/intro-code.md | 4 +-- web/html/computer-code/intro-kbd.md | 10 +++---- web/html/computer-code/intro-pre.md | 2 +- web/html/computer-code/intro-samp.md | 4 +-- web/html/computer-code/intro-var.md | 4 +-- .../core-html-elements-discussion-insight.md | 2 +- web/html/core-html-elements/headings-h1-h6.md | 8 +++--- web/html/core-html-elements/style-element.md | 2 +- .../core-html-elements/update-hyperlinks.md | 16 +++++------ web/html/formatting-elements/intro-hr.md | 2 +- web/html/formatting-elements/intro-span.md | 4 +-- .../editing-s-del-ins.md | 12 ++++---- .../emphasis-i-and-em.md | 6 ++-- .../important-b-and-strong.md | 6 ++-- .../sub-and-superscript-sub-and-sup.md | 2 +- web/html/html-basics/hyperlinks.md | 2 +- ...roperty-to-transform-text-to-small-caps.md | 2 +- 22 files changed, 60 insertions(+), 69 deletions(-) diff --git a/web/html/citation-elements/address.md b/web/html/citation-elements/address.md index 88e3421353..a09fba7155 100755 --- a/web/html/citation-elements/address.md +++ b/web/html/citation-elements/address.md @@ -25,7 +25,7 @@ revisionQuestion: ## Content -The HTML `

` element is used to provide contact information about the author. This element is displayed as a block element and has a default styling like the `` and `` elements (the text is italic). +The `
` element is used to provide contact information about the author. It is displayed as a block element and has a default styling like the `` and `` elements (the text is *italic*). ![address](https://img.enkipro.com/9ec8992af472e5a9d37e0d1f01a1d69a.png) diff --git a/web/html/citation-elements/blockquotes.md b/web/html/citation-elements/blockquotes.md index 3225f7678f..9a7310766b 100755 --- a/web/html/citation-elements/blockquotes.md +++ b/web/html/citation-elements/blockquotes.md @@ -23,9 +23,7 @@ revisionQuestion: ## Content -The HTML `
` element or the **Block Quotation** element is used to enclose text which represents an extended or long quotation. This element is displayed as a block element and usually has a 1em top/bottom margin added by default, as well as a left/right indentation of 40 pixels. This can all be editable with CSS styling. - -Example: +The `
`, or the **Block Quotation** element, is used to enclose text which represents an extended or long quotation. It is displayed as a block element, and usually has a `1em` top/bottom margin added by default as well as a left/right indentation of `40 pixels`. This is all editable with CSS styling. ```html
@@ -63,8 +61,7 @@ quotes/arthur_c_clarke_408582"> ![blockquote-with-cite](https://img.enkipro.com/f702ae2ea6852ec747ae0ee7518ea83b.png) -If you wish to add a short quote to your web page or document, you should use the `` or the **Quotation element**. -Example: +If you wish to add a short quote to your web page or document, you should use the `` or the **Quotation element**: ```html I have a dream! diff --git a/web/html/citation-elements/intro-bdo.md b/web/html/citation-elements/intro-bdo.md index 59817110e7..39bd5273b4 100755 --- a/web/html/citation-elements/intro-bdo.md +++ b/web/html/citation-elements/intro-bdo.md @@ -25,7 +25,7 @@ revisionQuestion: ## Content -The HTML ``, or the **Bidirectional Text Override** element, is used to override the current directionality of text. This means that you can have text written in one direction, render and display in the opposite direction. +The ``, or the **Bidirectional Text Override** element, is used to override the current directionality of text. This means that you can have text written in one direction, render and display in the opposite direction. This element can have only one attribute, `dir`, with only 2 two possible values: diff --git a/web/html/citation-elements/intro-cite.md b/web/html/citation-elements/intro-cite.md index bef0ace373..444f72c93d 100755 --- a/web/html/citation-elements/intro-cite.md +++ b/web/html/citation-elements/intro-cite.md @@ -24,19 +24,18 @@ revisionQuestion: ## Content -The HTML `` element is used to describe a reference of a cited **creative work**. This element needs to contain either the title or the URL of the cited work. +The `` element is used to describe a reference of a cited **creative work**. This element needs to contain either the title or the URL of the cited work. What falls under creative work: -- Any online content -- Any book -- Any computer program -- Any original writing -- Any exhibition -- Any video -- Any legal writings -- Any original artwork -- Any research paper +- Online content +- Books +- Computer programs +- Original writing or artwork +- Exhibitions +- Videos +- Legal writings +- Research paper ```html

@@ -49,7 +48,8 @@ What falls under creative work: ![cite](https://img.enkipro.com/28852f600f281af9f98989e02b4471bc.png) -The cited URL under the `` element will, by default, display in italic. However, this is easily editable by adding the `font-style` CSS property to the `` element and changing the default value to 'normal' or even 'oblique' (aka bold). + +By default, the URL under the `` element will display in *talic*. However, this is easily editable by adding the `font-style` CSS property to the `` element, and changing the default value to "normal" or even "oblique" (aka **bold**). [View CodePen](https://codepen.io/enkidevs/pen/xzyKBz) @@ -65,8 +65,8 @@ Which statement about the `` element is not correct? - displays as a block element - used for indicating a citation - default font style is italic -- works such as book, essay, poem, & script -- works such as movie, play, song, & TV show. +- used for books, essays, poems, or scripts +- used for movies, plays, songs, or TV Shows. - displays as an inline element @@ -92,7 +92,7 @@ and Technicolor.

``` -What HTML element is best to use in this example? +Which HTML element is best to use in this example? ```html tag = ??? diff --git a/web/html/citation-elements/intro-q.md b/web/html/citation-elements/intro-q.md index c65e5fa9c6..c13a8ddade 100755 --- a/web/html/citation-elements/intro-q.md +++ b/web/html/citation-elements/intro-q.md @@ -24,7 +24,7 @@ revisionQuestion: ## Content -The HTML ``, or the **Inline Quotation** element, is used for indicating short quotations. This element is displayed as an inline element and is typically used for short quotations that don't require paragraph breaks. On the other hand, if you need a larger quotation, you should use the `
` element. +The ``, or the **Inline Quotation** element, is displayed as an inline element and is typically used for short quotations that don't require paragraph breaks. On the other hand, if you need a larger quotation, you should use the `
` element. Most browsers display the `` element by placing quotation marks around the content. diff --git a/web/html/computer-code/intro-code.md b/web/html/computer-code/intro-code.md index 0e96312df9..7622b4343e 100755 --- a/web/html/computer-code/intro-code.md +++ b/web/html/computer-code/intro-code.md @@ -19,7 +19,7 @@ revisionQuestion: ## Content -The HTML `` element is used to display a fragment of a computer code. +The `` element is used to display a fragment of a computer code. Example: @@ -38,7 +38,7 @@ Code Result: ![code-element](https://img.enkipro.com/ac35ba3ba120e7bad24f65ba88ec7776.png) -The default font style for the `` element for most browsers is the monospace font. +For most browsers, the default font style for the `` element is the monospace font. > 💡 It's best to use the `` element to style content for HTML elements, CSS rules, filenames, and JS scripts. With a little CSS, the code used can stand out more on a page like this: diff --git a/web/html/computer-code/intro-kbd.md b/web/html/computer-code/intro-kbd.md index a6621bbbff..45fd261f74 100755 --- a/web/html/computer-code/intro-kbd.md +++ b/web/html/computer-code/intro-kbd.md @@ -24,9 +24,7 @@ revisionQuestion: ## Content -The HTML ``, or the **Keyboard Input** element, is used to represent user input, such as keys on a keyboard, voice commands, or any other textual input. - -Example: +The ``, or the **Keyboard Input** element, is used to represent user input, such as keys on a keyboard, voice commands, or any other textual input. ```html

@@ -36,13 +34,13 @@ Example:

``` -Keyboard Input Result: +Which looks like this: ![kbd-element](https://img.enkipro.com/1547a0d6d7db30a6fe78ee9d06385c90.png) -The default font style for the `` element for most browsers is the monospace font. +For most browsers, the default font style for the `` element is the monospace font. -By adding CSS styles, the `` element can be used to present the user input in much better ways. +By adding CSS styles, the `` element can present user input in a more visually pleasing way. ![kbd-element-styled](https://img.enkipro.com/5a394fbb97415d313778c2b81d93749e.png) diff --git a/web/html/computer-code/intro-pre.md b/web/html/computer-code/intro-pre.md index 499c1a7b4d..ce86802521 100755 --- a/web/html/computer-code/intro-pre.md +++ b/web/html/computer-code/intro-pre.md @@ -21,7 +21,7 @@ revisionQuestion: ## Content -The HTML `
`, or the **Pre-formatted Text** element, is used to display text exactly as it is within the HTML file. This means that text and all the spaces within the `
` element will all be displayed in the space exactly. This is useful since HTML typically ignores multiple spaces.
+The `
`, or the **Pre-formatted Text** element, is used to display text exactly as it is within the HTML file. This means that text and all the spaces within the `
` element will display exactly as they look. This is useful since HTML typically ignores multiple spaces.
 
 Example:
 
diff --git a/web/html/computer-code/intro-samp.md b/web/html/computer-code/intro-samp.md
index 9b1fefd845..637ae8da57 100755
--- a/web/html/computer-code/intro-samp.md
+++ b/web/html/computer-code/intro-samp.md
@@ -24,7 +24,7 @@ revisionQuestion:
 
 ## Content
 
-The HTML ``, or the **Sample Output** element, is used to represent a sample output from a computer program.
+The ``, or the **Sample Output** element, is used to represent a sample output from a computer program.
 
 Example:
 
@@ -40,7 +40,7 @@ Sample Output Result:
 
 The default font style for the `` element for most browsers is the monospace font.
 
-By adding CSS styles, the `` element can be used to present the sample output from a computer program in much better ways.
+By adding CSS styles, the `` element can be used to present the output from a computer program in a more visually pleasing way.
 
 ![samp-element-styled](https://img.enkipro.com/d2ec92c8d3a7be6ac739a44ee6ef01fc.png)
 
diff --git a/web/html/computer-code/intro-var.md b/web/html/computer-code/intro-var.md
index 054a87dee8..81e60497dd 100755
--- a/web/html/computer-code/intro-var.md
+++ b/web/html/computer-code/intro-var.md
@@ -24,7 +24,7 @@ revisionQuestion:
 
 ## Content
 
-The HTML ``, or the **Variable** element, is used to represent a name of a variable in either a programming context or a mathematical expression.
+The ``, or the **Variable** element, is used to represent a name of a variable in either a programming context or a mathematical expression.
 
 Example:
 
@@ -42,7 +42,7 @@ Variable Result:
 
 The default text style for the `` element for most browsers is both monospace and italic.
 
-By adding CSS styles, the `` element can be used to present variables in much better ways.
+By adding CSS styles, the `` element can display variables more clearly.
 
 ![var-element-style](https://img.enkipro.com/2015fe3ff38303e757e8f246d7c5b1a1.png)
 
diff --git a/web/html/core-html-elements/core-html-elements-discussion-insight.md b/web/html/core-html-elements/core-html-elements-discussion-insight.md
index 158653ea68..12aca35571 100644
--- a/web/html/core-html-elements/core-html-elements-discussion-insight.md
+++ b/web/html/core-html-elements/core-html-elements-discussion-insight.md
@@ -48,7 +48,7 @@ If you're stuck or need inspiration, check out our [playground example](https://
 
 > Here are some examples on how you can style your elements:
 
-Chaining css properties together.
+Chaining CSS properties together.
 
 ```css
 
diff --git a/web/html/core-html-elements/headings-h1-h6.md b/web/html/core-html-elements/headings-h1-h6.md
index f821b0f992..ab6aab8bb1 100755
--- a/web/html/core-html-elements/headings-h1-h6.md
+++ b/web/html/core-html-elements/headings-h1-h6.md
@@ -24,9 +24,9 @@ revisionQuestion:
 
 ## Content
 
-The HTML heading elements are very important when determining the style and structure of text within web pages.
+The HTML heading elements are essential when determining the style and structure of text within web pages.
 
-There are 6 headings in HTML5 ranging from `
` to `
`. `
` being the largest in size by default and most important by search engines. `
` being the smallest and least important of the text headings within a web page.
+There are 6 headings in HTML5 ranging from `
` to `
`. `
` being the largest by default and most important to search engines. `
` being the smallest and least important of the text headings within a web page.
 
 Example:
 
@@ -45,11 +45,11 @@ Headings appear like this:
 
 [View CodePen](https://codepen.io/enkidevs/pen/KBMMBb)
 
-Search engines interpret headings as part of your page and use the hierarchy to help understand the importance of the content of the web page. It is important that regardless of how much content the web page has, each web page has at least one `
` highlighting the most important topic of the page.
+Search engines interpret headings as part of your page and use the hierarchy to help understand the importance of the web page's content. It is important that regardless of how much content the web page has, each web page has at least one `
` highlighting the most important topic of the page.
 
 An `h1` should describe the topic of the entire page. `h2`'s typically describe primary blocks of content within the page, and `h3`'s describe less important blocks of content, etc.
 
-Headings are also useful for readability since users typically skim through pages primarily scanning the headings first. Thus, the size of the headings can help provide visual cues to the importance of different sections of the web pages.
+Headings are also helpful for readability since users typically skim through pages, primarily scanning the headings first. Thus, their size can help provide visual cues to the importance of different sections of the web pages.
 
 *Additional Tips:*
 
diff --git a/web/html/core-html-elements/style-element.md b/web/html/core-html-elements/style-element.md
index 891b6a4b77..f81295b4f6 100644
--- a/web/html/core-html-elements/style-element.md
+++ b/web/html/core-html-elements/style-element.md
@@ -24,7 +24,7 @@ revisionQuestion:
 
 ## Content
 
-The HTML `style` element is used to style the content of an html document. These styles are loaded with the HTML page and work even if external CSS fails to load for some reason. The `style` tag is often used to load **Critical CSS**[1]
+The `