Skip to content
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

fix: fixable flaws in Glossary A-D entries #1234

Merged
merged 1 commit into from
Jan 13, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions files/en-us/glossary/404/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,6 @@
<h2 id="Learn_more">Learn more</h2>

<ul>
<li><a href="/en-US/docs/Web/HTTP/Response_codes">list of HTTP response codes</a></li>
<li><a href="/en-US/docs/Learn/Checking_that_your_web_site_is_working_properly">advice for beginners on avoiding 404 errors</a></li>
<li><a href="/en-US/docs/Web/HTTP/Status">list of HTTP response codes</a></li>
<li><a href="/en-US/docs/Learn/Common_questions/Checking_that_your_web_site_is_working_properly">advice for beginners on avoiding 404 errors</a></li>
</ul>
2 changes: 1 addition & 1 deletion files/en-us/glossary/502/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -18,5 +18,5 @@
<h2 id="Learn_more">Learn more</h2>

<ul>
<li><a href="/en-US/docs/Web/HTTP/Response_codes">list of HTTP response codes</a></li>
<li><a href="/en-US/docs/Web/HTTP/Status">list of HTTP response codes</a></li>
</ul>
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion files/en-us/glossary/alpha/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@

<p>For example, the color <code>#8921F2</code> (also described as <code>rgb(137, 33, 242)</code> or <code>hsl(270, 89%, 54)</code>) is a nice shade of purple. Below you see a small box of that color in the top-left corner and a box of the <em>same</em> color but with an alpha channel set at 0.5 (50% opacity). The two boxes are drawn on top of a paragraph of text.</p>

<p style="text-align: center;"><img alt="Image showing the effect of an alpha channel on a color." src="https://mdn.mozillademos.org/files/17019/alpha-channel-example.png" style="height: 219px; width: 420px;"></p>
<p style="text-align: center;"><img alt="Image showing the effect of an alpha channel on a color." src="alpha-channel-example.png"></p>

<p>As you can see, the color without an alpha channel completely blocks the background text, while the box with the alpha channel leaves it visible through the purple background color.</p>

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/base64/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
---
<p><strong>Base64</strong> is a group of similar <a href="https://en.wikipedia.org/wiki/Binary-to-text_encoding">binary-to-text encoding</a> schemes that represent binary data in an ASCII string format by translating it into a radix-64 representation. The term <em>Base64</em> originates from a specific <a href="https://en.wikipedia.org/wiki/MIME#Content-Transfer-Encoding">MIME content transfer encoding</a>.</p>

<p>Base64 encoding schemes are commonly used when there is a need to encode binary data that needs to be stored and transferred over media that are designed to deal with ASCII. This is to ensure that the data remain intact without modification during transport. Base64 is commonly used in a number of applications including email via <a href="https://en.wikipedia.org/wiki/MIME">MIME</a>, and storing complex data in <a href="/en-US/docs/XML">XML</a>.</p>
<p>Base64 encoding schemes are commonly used when there is a need to encode binary data that needs to be stored and transferred over media that are designed to deal with ASCII. This is to ensure that the data remain intact without modification during transport. Base64 is commonly used in a number of applications including email via <a href="https://en.wikipedia.org/wiki/MIME">MIME</a>, and storing complex data in <a href="/en-US/docs/Web/XML">XML</a>.</p>

<p>One common application of base64 encoding on the web is to encode binary data  so it can be included in a <a href="/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs">data: URL</a>.</p>

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/bidi/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -18,5 +18,5 @@ <h3 id="General_knowledge">General knowledge</h3>
<h3 id="Technical_reference">Technical reference</h3>

<ul>
<li><a href="/en-US/Apps/Build/Localization/Developing_Bidi_Apps">Developing Bidi Apps</a></li>
<li><a href="/en-US/docs/Web/Apps/Build/Localization/Developing_Bidi_Apps">Developing Bidi Apps</a></li>
</ul>
2 changes: 1 addition & 1 deletion files/en-us/glossary/block/css/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ <h2 id="Learn_more">Learn more</h2>
<h3 id="General_knowledge">General knowledge</h3>

<ul>
<li><a href="/en-US/docs/Web/Guide/CSS/Visual_formatting_model">Visual formatting model</a></li>
<li><a href="/en-US/docs/Web/CSS/Visual_formatting_model">Visual formatting model</a></li>
</ul>

<div>{{QuickLinksWithSubpages("/en-US/docs/Glossary")}}</div>
2 changes: 1 addition & 1 deletion files/en-us/glossary/breadcrumb/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,6 @@

<p>A location breadcrumb for this document might look something like this:</p>

<p><a href="/">MDN</a> &gt; <a href="/en-US/docs/Glossary/">Glossary</a> &gt; Breadcrumb</p>
<p><a href="/">MDN</a> &gt; <a href="/en-US/docs/Glossary">Glossary</a> &gt; Breadcrumb</p>

<p>Breadcrumb trails enable users to be aware of their location within a website. This type of navigation, if done correctly, helps users know where they are in a site and how they got there. They can also help a user get back to where they were before and can reduce the number of clicks needed to get to a higher-level page.</p>
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions files/en-us/glossary/bézier_curve/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@

<p>To draw the curve, two imaginary lines are drawn, one from P<sub>0</sub> to P<sub>1</sub> and the other from P<sub>1</sub> to P<sub>2</sub>. The end points of the lines are then steadily moved to the next point. A third imaginary line is drawn with its starting point moving steadily on the first helper line and the end point on the second helper line. On this imaginary line a point is drawn from its starting point moving steadily to its end point. The curve this point describes is the Bézier curve. Here's an animated illustration demonstrating the creation of the curve:</p>

<p><img alt="Drawing a Bézier curve" src="https://upload.wikimedia.org/wikipedia/commons/d/db/B%C3%A9zier_3_big.gif"></p>
<p><img alt="Drawing a Bézier curve" src="bézier_3_big.gif"></p>

<h2 id="Learn_more">Learn more</h2>

Expand All @@ -26,7 +26,7 @@ <h3 id="General_knowledge">General knowledge</h3>
<h3 id="Learn_about_it">Learn about it</h3>

<ul>
<li><a href="/en-US/docs/Web/CSS/timing-function#The_cubic-bezier()_class_of_timing_functions">Cubic Bézier timing functions in CSS</a></li>
<li><a href="/en-US/docs/Web/CSS/easing-function#The_cubic-bezier()_class_of_timing_functions">Cubic Bézier timing functions in CSS</a></li>
<li>{{SVGAttr("keySplines")}} SVG attribute</li>
<li><a href="/en-US/docs/Web/CSS/Tools/Cubic_Bezier_Generator">Cubic Bézier Generator</a></li>
</ul>
4 changes: 2 additions & 2 deletions files/en-us/glossary/canvas/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -21,14 +21,14 @@ <h3 id="General_knowledge">General knowledge</h3>
<h3 id="Learning_resources">Learning resources</h3>

<ul>
<li><a href="/en-US/docs/Web/Guide/HTML/Canvas_tutorial">The Canvas tutorial on MDN</a></li>
<li><a href="/en-US/docs/Web/API/Canvas_API/Tutorial">The Canvas tutorial on MDN</a></li>
</ul>

<h3 id="Technical_information">Technical information</h3>

<ul>
<li>The HTML {{HTMLElement("canvas")}} element on MDN</li>
<li><a href="/en-US/docs/HTML/Canvas">The Canvas general documentation on MDN</a></li>
<li><a href="/en-US/docs/Web/API/Canvas_API">The Canvas general documentation on MDN</a></li>
<li>{{domxref("CanvasRenderingContext2D")}}: The canvas 2D drawing API</li>
<li><a href="https://www.w3.org/TR/2dcontext/" rel="external">The Canvas 2D API specification</a></li>
</ul>
5 changes: 2 additions & 3 deletions files/en-us/glossary/certified/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -18,13 +18,12 @@ <h2 id="Learn_more">Learn more</h2>
<h3 id="General_knowledge">General knowledge</h3>

<ul>
<li><a href="/en-US/docs/Learn/tutorial/Information_Security_Basics">Information security tutorial</a></li>
<li><a href="/en-US/docs/Web/Security/Information_Security_Basics">Information security tutorial</a></li>
<li>{{Interwiki("wikipedia", "Professional_certification_(computer_technology)#Information_systems_security", "Certification")}} on Wikipedia</li>
</ul>

<h3 id="Firefox_OS">Firefox OS</h3>

<ul>
<li>Internal apps on Firefox OS are also sometimes called certified apps: see <a href="/en-US/Apps/Build/App_permissions">App permissions</a> for more.</li>
<li>Internal apps on Firefox OS are also sometimes called certified apps: see <a href="/en-US/docs/Web/Apps/Build/App_permissions">App permissions</a> for more.</li>
</ul>

2 changes: 1 addition & 1 deletion files/en-us/glossary/character_encoding/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
<p>For example, in HTML we normally declare a character encoding of UTF-8, using the following line:</p>

<div class="example">
<pre class="brush: html"><code>&lt;meta charset="utf-8"&gt;</code></pre>
<pre class="brush: html">&lt;meta charset=&quot;utf-8&quot;&gt;</pre>

<p>This ensures that you can use characters from just about any human language in your HTML document, and they will display reliably.</p>
</div>
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/class/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ <h3 id="General_knowledge">General knowledge</h3>

<ul>
<li><a href="/en-US/docs/Web/JavaScript/Guide/Details_of_the_Object_Model#Class-based_vs._prototype-based_languages">Class-based vs. prototype-based programming languages</a> (like JavaScript)</li>
<li><a href="/en-US/docs/Web/JavaScript/Introduction_to_Object-Oriented_JavaScript#The_Class">Using functions as classes in JavaScript</a></li>
<li><a href="/en-US/docs/Learn/JavaScript/Objects#The_Class">Using functions as classes in JavaScript</a></li>
<li><a href="https://en.wikipedia.org/wiki/Class-based_programming">Class-based programming</a> on Wikipedia</li>
<li><a href="https://en.wikipedia.org/wiki/Object-oriented_programming">Object-oriented programming</a> on Wikipedia</li>
</ul>
2 changes: 1 addition & 1 deletion files/en-us/glossary/code_splitting/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ <h2 id="See_also">See also</h2>

<ul>
<li>Bundling</li>
<li><a href="/en-US/docs/Learn/Performance/Lazy_loading">Lazy loading</a></li>
<li><a href="/en-US/docs/Web/Performance/Lazy_loading">Lazy loading</a></li>
<li><a href="/en-US/docs/Glossary/HTTP_2">HTTP/2</a></li>
<li><a href="/en-US/docs/Glossary/Tree_shaking">Tree shaking</a></li>
</ul>
2 changes: 1 addition & 1 deletion files/en-us/glossary/constructor/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,6 @@ <h3 id="General_knowledge">General knowledge</h3>
<h3 id="Technical_reference">Technical reference</h3>

<ul>
<li><a href="/en-US/docs/Web/JavaScript/Introduction_to_Object-Oriented_JavaScript#The_Constructor">The constructor in object oriented programming for JavaScript</a> on MDN</li>
<li><a href="/en-US/docs/Learn/JavaScript/Objects#The_Constructor">The constructor in object oriented programming for JavaScript</a> on MDN</li>
<li><a href="/en-US/docs/Web/JavaScript/Reference/Operators/new">New operator in JavaScript</a> on MDN</li>
</ul>
2 changes: 1 addition & 1 deletion files/en-us/glossary/control_flow/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -42,5 +42,5 @@ <h3 id="Technical_reference">Technical reference</h3>
<h3 id="Learn_about_it">Learn about it</h3>

<ul>
<li><a href="/en-US/docs/Web/JavaScript/Guide/Statements">Statements (Control flow)</a> on MDN</li>
<li><a href="/en-US/docs/Web/JavaScript/Guide/Control_flow_and_error_handling">Statements (Control flow)</a> on MDN</li>
</ul>
Binary file added files/en-us/glossary/cross_axis/basics3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added files/en-us/glossary/cross_axis/basics4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions files/en-us/glossary/cross_axis/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,11 @@
---
<p>The cross axis in {{glossary("flexbox")}} runs perpendicular to the {{glossary("main axis")}}, therefore if your {{cssxref("flex-direction")}} is either <code>row</code> or <code>row-reverse</code> then the cross axis runs down the columns.</p>

<p><img alt="The cross axis runs down the column" src="https://mdn.mozillademos.org/files/15710/Basics3.png" style="display: block; height: 125px; margin: 0px auto; width: 666px;"></p>
<p><img alt="The cross axis runs down the column" src="basics3.png" style="display: block; margin: 0px auto;"></p>

<p>If your main axis is <code>column</code> or <code>column-reverse</code> then the cross axis runs along the rows.</p>

<p><img alt="The cross axis runs along the row." src="https://mdn.mozillademos.org/files/15711/Basics4.png" style="display: block; height: 244px; margin: 0px auto; width: 523px;"></p>
<p><img alt="The cross axis runs along the row." src="basics4.png" style="display: block; margin: 0px auto;"></p>

<p>Alignment of items on the cross axis is achieved with the <code>align-items</code> property on the flex container or <code>align-self</code> property on individual items. In the case of a multi-line flex container, with additional space on the cross axis, you can use <code>align-content</code> to control the spacing of the rows.</p>

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/cryptography/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
<li>General knowledge
<ol>
<li>{{Interwiki("wikipedia", "Cryptography")}} on Wikipedia</li>
<li><a href="/en-US/docs/Learn/tutorial/Information_Security_Basics">Information security tutorial</a></li>
<li><a href="/en-US/docs/Web/Security/Information_Security_Basics">Information security tutorial</a></li>
<li><a href="/en-US/docs/Archive/Security/Encryption_and_Decryption">Encrypting and Decrypting</a></li>
</ol>
</li>
Expand Down
10 changes: 5 additions & 5 deletions files/en-us/glossary/css_selector/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@

<section id="Quick_links">
<ol>
<li><a href="/en-US/docs/Learn/CSS/Introduction_to_CSS/Selectors">Learn more about CSS selectors</a> in our introduction to CSS.</li>
<li><a href="/en-US/docs/Learn/CSS/Building_blocks/Selectors">Learn more about CSS selectors</a> in our introduction to CSS.</li>
<li>Basic selectors
<ol>
<li><a href="/en-US/docs/Web/CSS/Type_selectors">Type selectors</a> <code>elementname</code></li>
Expand All @@ -74,10 +74,10 @@
</li>
<li>Combinators
<ol>
<li><a href="/en-US/docs/Web/CSS/Adjacent_sibling_selectors">Adjacent sibling selectors</a> <code>A + B</code></li>
<li><a href="/en-US/docs/Web/CSS/General_sibling_selectors">General sibling selectors</a> <code>A ~ B</code></li>
<li><a href="/en-US/docs/Web/CSS/Child_selectors">Child selectors</a> <code>A &gt; B</code></li>
<li><a href="/en-US/docs/Web/CSS/Descendant_selectors">Descendant selectors</a> <code>A B</code></li>
<li><a href="/en-US/docs/Web/CSS/Adjacent_sibling_combinator">Adjacent sibling selectors</a> <code>A + B</code></li>
<li><a href="/en-US/docs/Web/CSS/General_sibling_combinator">General sibling selectors</a> <code>A ~ B</code></li>
<li><a href="/en-US/docs/Web/CSS/Child_combinator">Child selectors</a> <code>A &gt; B</code></li>
<li><a href="/en-US/docs/Web/CSS/Descendant_combinator">Descendant selectors</a> <code>A B</code></li>
</ol>
</li>
<li>Pseudo
Expand Down
Binary file added files/en-us/glossary/decryption/decryption.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion files/en-us/glossary/decryption/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
<p>Decryption is a cryptographic primitive: it transforms a ciphertext message into plaintext using a cryptographic algorithm called a {{glossary("cipher")}}. Like encryption, decryption in modern ciphers is performed using a specific algorithm and a secret, called the {{glossary("key")}}. Since the algorithm is often public, the key must stay secret if the encryption stays secure.</p>


<p><img alt="The decryption primitive." src="https://mdn.mozillademos.org/files/9817/Decryption.png" style="height: 81px; width: 485px;"></p>
<p><img alt="The decryption primitive." src="decryption.png"></p>

<p>Decryption is the reverse of {{glossary("encryption")}} and if the key stays secret, decryption without knowing the specific secret, decryption is mathematically hard to perform. How hard depends on the security of the cryptographic algorithm chosen and evolves with the progress of {{glossary("cryptanalysis")}}.</p>

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/dns/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,6 @@ <h2 id="Learn_more">Learn more</h2>
<h3 id="General_knowledge">General knowledge</h3>

<ul>
<li><a href="/en-US/docs/Learn/Understanding_domain_names">Understanding domain names</a></li>
<li><a href="/en-US/docs/Learn/Common_questions/What_is_a_domain_name">Understanding domain names</a></li>
<li>{{Interwiki("wikipedia", "Domain_Name_System", "Domain Name System")}} on Wikipedia</li>
</ul>
4 changes: 2 additions & 2 deletions files/en-us/glossary/doctype/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -9,15 +9,15 @@
- HTML
- Intro
---
<p>In {{Glossary("HTML")}}, the doctype is the required "<code>&lt;!DOCTYPE html&gt;</code>" preamble found at the top of all documents. Its sole purpose is to prevent a {{Glossary("browser")}} from switching into so-called <a href="/en-US/docs/Quirks_Mode_and_Standards_Mode">“quirks mode”</a> when rendering a document; that is, the "<code>&lt;!DOCTYPE html&gt;</code>" doctype ensures that the browser makes a best-effort attempt at following the relevant specifications, rather than using a different rendering mode that is incompatible with some specifications.</p>
<p>In {{Glossary("HTML")}}, the doctype is the required "<code>&lt;!DOCTYPE html&gt;</code>" preamble found at the top of all documents. Its sole purpose is to prevent a {{Glossary("browser")}} from switching into so-called <a href="/en-US/docs/Web/HTML/Quirks_Mode_and_Standards_Mode">“quirks mode”</a> when rendering a document; that is, the "<code>&lt;!DOCTYPE html&gt;</code>" doctype ensures that the browser makes a best-effort attempt at following the relevant specifications, rather than using a different rendering mode that is incompatible with some specifications.</p>

<h2 id="Learn_more">Learn more</h2>

<h3 id="General_Knowledge">General Knowledge</h3>

<ul>
<li><a href="https://html.spec.whatwg.org/multipage/syntax.html#the-doctype">Definition of the DOCTYPE in the HTML specification</a></li>
<li><a href="/en-US/docs/Quirks_Mode_and_Standards_Mode">Quirks Mode and Standards Mode</a></li>
<li><a href="/en-US/docs/Web/HTML/Quirks_Mode_and_Standards_Mode">Quirks Mode and Standards Mode</a></li>
</ul>

<h3 id="Technical_reference">Technical reference</h3>
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/dom/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@
<section id="Quick_links">
<ol>
<li>{{interwiki("wikipedia", "Document_Object_Model", "The Document Object Model")}} on Wikipedia</li>
<li><a href="/en-US/docs/DOM">The DOM documentation on MDN</a></li>
<li><a href="/en-US/docs/Web/API/Document_Object_Model">The DOM documentation on MDN</a></li>
<li><a href="https://dom.spec.whatwg.org/" rel="external">The DOM Standard</a></li>
<li><a href="/en-US/docs/Glossary">Glossary</a>
<ol>
Expand Down