Skip to content
Open
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
2 changes: 1 addition & 1 deletion files/en-us/glossary/accessibility_tree/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ There are four properties in an accessibility tree object:

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 as of April 2022, 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.
While still in draft form within the Web Incubator Community Group as of April 2022, the **[Accessibility Object Model](https://wicg.github.io/aom/explainer.html) (AOM)** intends to incubate APIs that enable expressing accessibility semantics and potentially allow read access to the computed accessibility tree.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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


## See also

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/color_wheel/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ A **color wheel**, or a _color circle_, represents a palette of colors in chart

Color wheels are convenient for comparing colors expressed in polar or cylindrical coordinates, like [`hsl()`](/en-US/docs/Web/CSS/Reference/Values/color_value/hsl), [`hwb()`](/en-US/docs/Web/CSS/Reference/Values/color_value/hwb), or [`lch()`](/en-US/docs/Web/CSS/Reference/Values/color_value/lch).

In such cases, _complementary colors_ are often found opposite on the same diameter. Similarly, _monochromatic colors_ – colors of the same _tone_ but of different _shades_ – are located on the same radius, and _triadic colors_ – three colors evenly spaced around the color wheel that lead to colors that work well together – are also easy to find.
In such cases, _complementary colors_ are often found opposite on the same diameter. Similarly, _monochromatic colors_ – colors of the same _tone_ but of different _shades_ – are located on the same radius, and _triadic colors_ – three colors evenly spaced around the color wheel that lead to colors that work well together.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
In such cases, _complementary colors_ are often found opposite on the same diameter. Similarly, _monochromatic colors_ – colors of the same _tone_ but of different _shades_are located on the same radius, and _triadic colors_three colors evenly spaced around the color wheel that lead to colors that work well together.
In such cases, _complementary colors_ are often found at opposite positions on the same diameter, and _triadic colors_ (a set of three colors that complement each other) are evenly spaced around the color wheel. Similarly, _monochromatic colors_ – colors of the same _tone_ but of different _shades_ – are located on the same radius.

I can understand why you removed that last bit, but it made the sentence read strangely.


Color wheels are used in real life when we want to choose between different hues. For example, when selecting wall paint or the color for a piece of furniture.

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/continuous_integration/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ sidebar: glossarysidebar

Continuous integration (CI) is a software development practice in which changes to the source are frequently integrated into the main codebase.

It's an important practice whenever a team of developers is working on a shared codebase. In this situation, different developers might be making overlapping changes to the code at the same time, each in their personal branches. Frequent integration of each developer's changes makes it much less likely that conflicts will occur, and much easier to resolve them when they do.
It's an important practice whenever a team of developers is working on a shared codebase. In this situation, different developers might be making overlapping changes to the code at the same time, each in their personal branches. Frequent integration of each developer's changes makes it much less likely that conflicts will occur, and much more intuitive to resolve them when they do.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
It's an important practice whenever a team of developers is working on a shared codebase. In this situation, different developers might be making overlapping changes to the code at the same time, each in their personal branches. Frequent integration of each developer's changes makes it much less likely that conflicts will occur, and much more intuitive to resolve them when they do.
It's an important practice whenever a team of developers is working on a shared codebase. In this situation, different developers might be making overlapping changes to the code at the same time, each in their personal branches. Frequent integration of each developer's changes makes conflicts less likely to occur and more intuitive to resolve.


As [Martin Fowler observes](https://martinfowler.com/articles/continuousIntegration.html#EveryonePushesCommitsToTheMainlineEveryDay):

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/css_preprocessor/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ sidebar: glossarysidebar

A **CSS preprocessor** is a program that lets you generate {{Glossary("CSS")}} from the preprocessor's own unique {{Glossary("syntax")}}.

There are many CSS preprocessors to choose from, however most CSS preprocessors will add some features that don't exist in pure CSS, such as mixin, nesting selector, inheritance selector, and so on. These features make the CSS structure more readable and easier to maintain.
There are many CSS preprocessors to choose from, however most CSS preprocessors will add some features that don't exist in pure CSS, such as mixin, nesting selector, inheritance selector, and so on. These features make the CSS structure more readable and maintainable.

To use a CSS preprocessor, you must install a CSS compiler on your web {{Glossary("server")}}; Or use the CSS preprocessor to compile on the development environment, and then upload compiled CSS file to the web server.

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/database/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ page-type: glossary-definition
sidebar: glossarysidebar
---

A **database** is a storing system that collects organized data, to make some works easier like searching, structure, and extend.
A **database** is a storing system that collects organized data, enabling tasks like searching, structure, and extend.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
A **database** is a storing system that collects organized data, enabling tasks like searching, structure, and extend.
A **database** is a storage system that collects organized data, making it easier to search, structure, and extend.


In web development, most databases use the relational database management system (RDBMS) to organize data and programming in {{glossary("SQL")}}. Some databases, however, don't follow the former mechanism to organized data, which called NoSQL.

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/localization/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ The following are common factors to consider:
- local holidays
- personal names

The complementary practice, of designing a system so it is easy to localize, is called {{glossary("Internationalization")}}.
The complementary practice, of designing a system so it is more readily localizable, is called {{glossary("Internationalization")}}.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The complementary practice, of designing a system so it is more readily localizable, is called {{glossary("Internationalization")}}.
The complementary practice of making a system easier to localize is called {{glossary("Internationalization")}}.


## See also

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/progressive_web_apps/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ sidebar: glossarysidebar

These kinds of apps enjoy all the best parts of the Web — such as discoverability via search engines, being linkable via {{Glossary("URL")}}s, and working across multiple form factors, but are progressively enhanced with modern APIs (such as [Service Workers](/en-US/docs/Web/API/Service_Worker_API) and [Push](/en-US/docs/Web/API/Push_API)).

These features include being installable, working offline, and being easy to sync with and re-engage the user from the server.
These features include being installable, working offline, and syncing with and re-engaging the user from the server.

## See also

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/sloppy_mode/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ page-type: glossary-definition
sidebar: glossarysidebar
---

{{Glossary("ECMAScript")}} 5 and later let scripts opt in to a new [strict mode](/en-US/docs/Web/JavaScript/Reference/Strict_mode), which alters the semantics of JavaScript in several ways to improve its resiliency and which make it easier to understand what's going on when there are problems.
{{Glossary("ECMAScript")}} 5 and later let scripts opt in to a new [strict mode](/en-US/docs/Web/JavaScript/Reference/Strict_mode), which alters the semantics of JavaScript in several ways to improve its resiliency and which make what's going on more understandable when there are problems.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
{{Glossary("ECMAScript")}} 5 and later let scripts opt in to a new [strict mode](/en-US/docs/Web/JavaScript/Reference/Strict_mode), which alters the semantics of JavaScript in several ways to improve its resiliency and which make what's going on more understandable when there are problems.
{{Glossary("ECMAScript")}} 5 and later let scripts opt in to a new [strict mode](/en-US/docs/Web/JavaScript/Reference/Strict_mode), which alters the semantics of JavaScript in several ways to improve its resilience and make errors more understandable.


The normal, non-strict mode of JavaScript is sometimes referred to as **sloppy mode**. This isn't an official designation, but you are likely to come across it if you spend time doing serious JavaScript code.

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/source_map/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Code executed by the browser is often transformed in some way from the original
- To support older browsers by transforming modern features into older equivalents.
- To use languages that browsers don't support, like {{Glossary("TypeScript")}} or [Sass](https://sass-lang.com/).

In these situations, debugging the original source is much easier than the source in the transformed state that the browser has downloaded.
In these situations, debugging the original source is more intuitive than the source in the transformed state that the browser has downloaded.
Browsers detect a source map via the {{HTTPHeader("SourceMap")}} HTTP header for a resource, or a `sourceMappingURL` annotation in the generated code.

## Example
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/ssg/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ sidebar: glossarysidebar

A **static site generator** (SSG) is a software used to generate _static_ websites. A static website is comprised of {{glossary("HTML")}}, {{glossary("CSS")}}, and {{glossary("JavaScript")}} files. Most importantly static sites do not have [server-side logic](/en-US/docs/Learn_web_development/Extensions/Server-side), so for any given URL, all users will receive the same content. Authors write content in any form accepted by the generator, such as Markdown, reStructuredText, HTML, (and sometimes even [React](/en-US/docs/Learn_web_development/Core/Frameworks_libraries/React_getting_started), and so on), and the generator compiles them into a set of optimized static files that can be rendered by the browser.

Static sites are commonly used for blogs, documentation, and other content-driven websites, which don't have data that needs to be fetched or generated server-side. They are fast, secure, and easy to deploy, because they can be served from a {{glossary("CDN")}}.
Static sites are commonly used for blogs, documentation, and other content-driven websites, which don't have data that needs to be fetched or generated server-side. They are fast, secure, and easier to deploy, because they can be served from a {{glossary("CDN")}}.

## See also

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/ux/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ page-type: glossary-definition
sidebar: glossarysidebar
---

**UX** is an acronym that stands for User eXperience. It is the study of the interaction between users and a system. Its goal is to make a system easy to interact with from the user's point of view.
**UX** is an acronym that stands for User eXperience. It is the study of the interaction between users and a system. Its goal is to make a system intuitive and easy to interact with from the user's point of view.

The system can be any kind of product or application that an end user is meant to interact with. UX studies undertaken on a web page for example can demonstrate whether it is easy for users to understand the page, navigate to different areas, and complete common tasks, and where such processes could have less friction.

Expand Down