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

[Markdown] [Glossary] Convert Glossary to markdown - DO NOT SQUASH MERGE #9630

Merged
merged 3 commits into from
Oct 8, 2021
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
17 changes: 0 additions & 17 deletions files/en-us/glossary/404/index.html

This file was deleted.

15 changes: 15 additions & 0 deletions files/en-us/glossary/404/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
---
title: '404'
slug: Glossary/404
tags:
- Glossary
- HTTP Errors
- Infrastructure
- Navigation
---
A 404 is a Standard Response Code meaning that the {{Glossary("Server", "server")}} cannot find the requested resource.

## See also

- [list of HTTP response codes](/en-US/docs/Web/HTTP/Status)
- [advice for beginners on avoiding 404 errors](/en-US/docs/Learn/Common_questions/Checking_that_your_web_site_is_working_properly)
22 changes: 0 additions & 22 deletions files/en-us/glossary/502/index.html

This file was deleted.

20 changes: 20 additions & 0 deletions files/en-us/glossary/502/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
title: '502'
slug: Glossary/502
tags:
- '502'
- Bad Gateway
- Glossary
- HTTP Errors
- Infrastructure
- Navigation
---
An {{Glossary("HTTP")}} error code meaning "Bad Gateway".

A {{Glossary("Server", "server")}} can act as a gateway or proxy (go-between) between a client (like your Web browser) and another, upstream server. When you request to access a {{Glossary("URL")}}, the gateway server can relay your request to the upstream server. "502" means that the upstream server has returned an invalid response.

Normally the upstream server is not down (i.e. furnishes no response to the gateway/proxy), but does not understand the same data-exchange protocol as the gateway/proxy. Internet {{Glossary("Protocol", "protocols")}} are quite explicit, and so a 502 usually means that one or both machines were incorrectly or incompletely programmed.

## See also

- [list of HTTP response codes](/en-US/docs/Web/HTTP/Status)
47 changes: 0 additions & 47 deletions files/en-us/glossary/abstraction/index.html

This file was deleted.

45 changes: 45 additions & 0 deletions files/en-us/glossary/abstraction/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
---
title: Abstraction
slug: Glossary/Abstraction
tags:
- Abstraction
- Coding
- CodingScripting
- Glossary
- Programming Language
---
Abstraction in {{Glossary("computer programming")}} is a way to reduce complexity and allow efficient design and implementation in complex software systems. It hides the technical complexity of systems behind simpler {{Glossary("API", "APIs")}}.

## Advantages of Data Abstraction

- Helps the user to avoid writing low level code.
- Avoids code duplication and increases reusability.
- Can change internal implementation of class independently without affecting the user.
- Helps to increase security of an application or program as only important details are provided to the user.

## Example

```js
class ImplementAbstraction {
// method to set values of internal members
set(x, y) {
this.a = x;
this.b = y;
}

display() {
console.log('a = ' + this.a);
console.log('b = ' + this.b);
}
}

const obj = new ImplementAbstraction();
obj.set(10, 20);
obj.display();
// a = 10
// b = 20
```

## See also

- {{interwiki("wikipedia", "Abstraction (computer science)", "Abstraction")}} on Wikipedia
25 changes: 0 additions & 25 deletions files/en-us/glossary/accent/index.html

This file was deleted.

23 changes: 23 additions & 0 deletions files/en-us/glossary/accent/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
---
title: accent
slug: Glossary/accent
tags:
- Glossary
- Input
- accent
---
An **accent** is a typically bright color that contrasts with the more utilitarian background and foreground colors within a color scheme. These are present in the visual style of many platforms (though not all).

On the web, an accent is sometimes used in {{HTMLElement("input")}} elements for the active portion of the control, for instance the background of a checked [checkbox](/en-US/docs/Web/HTML/Element/input/checkbox).

## See also

### CSS related to the accent

You can set the color of the accent for a given element by setting the element's CSS {{cssxref("accent-color")}} property to the appropriate {{cssxref("<color>")}} value.

### HTML elements that may have an accent

- [`<input type="checkbox">`](/en-US/docs/Web/HTML/Element/input/checkbox)
- [`<input type="radio">`](/en-US/docs/Web/HTML/Element/input/radio)
- [`<input type="range">`](/en-US/docs/Web/HTML/Element/input/range)
20 changes: 0 additions & 20 deletions files/en-us/glossary/accessibility/index.html

This file was deleted.

18 changes: 18 additions & 0 deletions files/en-us/glossary/accessibility/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
---
title: Accessibility
slug: Glossary/Accessibility
tags:
- Accessibility
- Glossary
---
_Web Accessibility_ (**A11Y**) refers to best practices for keeping a website usable despite physical and technical restrictions. Web accessibility is formally defined and discussed at the {{Glossary("W3C")}} through the {{Glossary("WAI","Web Accessibility Initiative")}} (WAI).

## See also

- [Accessibility resources at MDN](/en-US/docs/Web/Accessibility)
- {{Interwiki("wikipedia", "Web accessibility")}} on Wikipedia
- [Learn accessibility on MDN](/en-US/docs/Learn/Accessibility)
- [Web Accessibility In Mind](https://webaim.org/)
- [The ARIA documentation on MDN](/en-US/docs/Web/Accessibility/ARIA)
- [The Web Accessibility Initiative homepage](https://www.w3.org/WAI/)
- [The WAI-ARIA recommendation](https://www.w3.org/TR/wai-aria/)
41 changes: 0 additions & 41 deletions files/en-us/glossary/accessibility_tree/index.html

This file was deleted.

35 changes: 35 additions & 0 deletions files/en-us/glossary/accessibility_tree/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
---
title: Accessibility tree
slug: Glossary/Accessibility_tree
tags:
- AOM
- Accessibility
- DOM
- Glossary
- Reference
---
The **accessibility tree** contains {{Glossary("accessibility")}}-related information for most HTML elements.

Browsers convert markup into an internal representation called the _[DOM tree](/en-US/docs/Web/API/Document_object_model/How_to_create_a_DOM_tree)_. The DOM tree contains objects representing all the markup’s elements, attributes, and text nodes. Browsers then create an accessibility tree based on the DOM tree, which is used by platform-specific Accessibility APIs to provide a representation that can be understood by assistive technologies, such as screen readers.

There are four things in an accessibility tree object:

- **name**
- : How can we refer to this thing? For instance, a link with the text "Read more" will have "Read more" as its name (find more on how names are computed in the [Accessible Name and Description Computation spec](https://www.w3.org/TR/accname-1.1/)).
- **description**
- : How do we describe this thing, if we want to provide more description beyond the name? The description of a table could explain what kind of information the table contains.
- **role**
- : What kind of thing is it? For example, is it a button, a nav bar, or a list of items?
- **state**
- : Does it have a state? Examples include checked or unchecked for checkboxes, and collapsed or expanded for the [`<summary>`](/en-US/docs/Web/HTML/Element/summary) element.

Additionally, the accessibility tree often contains information on what can be done with an element: a link can be _followed_, a text input can be _typed into_, etc.

While still in draft form within the Web Incubator Community Group, the **[Accessibility Object Model](https://wicg.github.io/aom/explainer.html) (AOM)** intends to incubate APIs that make it easier to express accessibility semantics and potentially allow read access to the computed accessibility tree.

## See also

- [Glossary](/en-US/docs/Glossary)

- {{Glossary("Accessibility")}}
- {{Glossary("ARIA")}}
26 changes: 0 additions & 26 deletions files/en-us/glossary/adobe_flash/index.html

This file was deleted.

23 changes: 23 additions & 0 deletions files/en-us/glossary/adobe_flash/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
---
title: Adobe Flash
slug: Glossary/Adobe_Flash
tags:
- Adobe
- CodingScripting
- Flash
- Glossary
- Infrastructure
---
Flash is a deprecated technology developed by Adobe for viewing expressive web applications, multimedia content, and streaming media. Adobe Flash can run from supporting {{Glossary("Browser","web browsers")}} via a browser plug-in.

## See also

- [Official web site](https://www.adobe.com/products/flashruntimes.html)
- [Shumway, a free implementation by Mozilla](https://mozilla.github.io/shumway/)
- [Gnash, a free implementation by GNU](http://gnashdev.org/)
- [Ruffle, a free implementation](https://ruffle.rs)
- [Glossary](/en-US/docs/Glossary)

1. {{Glossary("Browser")}}

- {{Interwiki("wikipedia", "Adobe Flash")}} (Wikipedia)
Loading