Skip to content

Commit 5f80f8f

Browse files
authored
Merge branch 'redhat-documentation:main' into main
2 parents 2ce4581 + 6f864f9 commit 5f80f8f

File tree

15 files changed

+324
-38
lines changed

15 files changed

+324
-38
lines changed

supplementary_style_guide/glossary_terms_conventions/general_conventions/a.adoc

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -149,6 +149,7 @@ _Specify the system architecture of your cluster, such as `x86_64` or `aarch64`.
149149
*See also*: xref:activemq-artemis[ActiveMQ Artemis], xref:jboss-eap-messaging[JBoss EAP messaging]
150150

151151
// EAP: Added "In Red Hat JBoss Enterprise Application Platform,"
152+
152153
[[activemq-artemis]]
153154
==== image:images/caution.png[with caution] ActiveMQ Artemis (noun)
154155
*Description*: In Red Hat JBoss Enterprise Application Platform, use "ActiveMQ Artemis" only when describing the technology used to implement the built-in messaging for JBoss EAP.
@@ -409,6 +410,16 @@ An Ansible task is a set of instructions to achieve a state defined, in its broa
409410

410411
*See also*: xref:app[app]
411412

413+
[[application-stream]]
414+
==== image:images/yes.png[yes] Application Stream (noun)
415+
*Description*: _Application Streams_ are multiple versions of Red Hat Enterprise Linux user-space components that are delivered and updated more frequently than the core operating system packages. Application Streams can be packaged as RPM packages, modules, or Software Collections. Do not confuse Application Streams with "AppStream", the repository through which Application Streams and other components are distributed.
416+
417+
*Use it*: yes
418+
419+
*Incorrect forms*: AppStream, application stream, Application stream
420+
421+
*See also*: xref:appstream-repository[AppStream repository]
422+
412423
[[applixware]]
413424
==== image:images/yes.png[yes] Applixware (noun)
414425
*Description*: _Applixware_ is a suite of proprietary modular applications for Linux.
@@ -419,6 +430,16 @@ An Ansible task is a set of instructions to achieve a state defined, in its broa
419430

420431
*See also*:
421432

433+
[[appstream-repository]]
434+
==== image:images/yes.png[yes] AppStream repository (noun)
435+
*Description*: The _AppStream repository_ distributes RHEL content as Application Streams and other components. Do not confuse the AppStream repository with the Application Streams that it distributes.
436+
437+
*Use it*: yes
438+
439+
*Incorrect forms*: Appstream, appstream, Application Stream
440+
441+
*See also*: xref:application-stream[Application Stream]
442+
422443
[[arp]]
423444
==== image:images/yes.png[yes] ARP (noun)
424445
*Description*: Within a subnet of an Ethernet network, hosts use the Address Resolution Protocol (_ARP_) to discover the Media Access Control (MAC) address that is associated with an IPv4 address. In IPv6 networks, the Neighbor Discovery Protocol (NDP) provides the functionality of ARP.
@@ -568,6 +589,7 @@ An Ansible task is a set of instructions to achieve a state defined, in its broa
568589

569590
*See also*: xref:xplat[Microsoft Azure Cross-Platform Command-Line Interface]
570591

592+
571593
[[arm64]]
572594
==== image:images/yes.png[yes] ARM64 (noun)
573595
*Description*: A 64-bit version of the ARM architecture. Use this term for OpenShift Container Platform (OCP) attributes, Kubernetes, Operators, APIs, and CLI objects. Use this format in general sentences when referring to OCP features.
@@ -600,6 +622,26 @@ _Valid values are `arm64`._
600622

601623
*See also*: xref:ARM64[ARM64]
602624

625+
[[aws-local-zone]]
626+
==== image:images/yes.png[yes] AWS Local Zone (noun)
627+
*Description*: An _Amazon Web Services (AWS) Local Zone_ represents a location that places cloud resources closer to a metropolitan AWS Region. An AWS Local Zone location is prepended by an AWS Region code that is followed by an identifier, such as `us-west-2-lax-1a`.
628+
629+
*Use it*: yes
630+
631+
*Incorrect forms*: Local Zone, LZ, local zone
632+
633+
*See also*: xref:opt-in[opt in], xref:aws-opt-in-region[AWS opt-in Region]
634+
635+
[[aws-opt-in-region]]
636+
==== image:images/yes.png[yes] AWS opt-in Region (noun)
637+
*Description*: An _Amazon Web Services (AWS) opt-in Region_ represents a world-wide location, which hosts Amazon's cloud-computing resources, where a customer must opt in to the AWS Region before they can deploy their OpenShift Container Platform cluster in this location. An AWS Region is represented by a regional service endpoint code, such as `us-east-2`.
638+
639+
*Use it*: yes
640+
641+
*Incorrect forms*: AWS region, AWS opt in Region
642+
643+
*See also*: xref:opt-in[opt in]
644+
603645
// Azure: Added "In Microsoft Azure" and removed "Microsoft Azure" from later in the sentence
604646
[[arm]]
605647
==== image:images/yes.png[yes] Azure Resource Manager (noun)

supplementary_style_guide/glossary_terms_conventions/general_conventions/b.adoc

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -71,6 +71,16 @@
7171

7272
*See also*: xref:distinguished-name[distinguished name]
7373

74+
[[baseos-repository]]
75+
==== image:images/yes.png[yes] BaseOS repository (noun)
76+
*Description*: In Red Hat Enterprise Linux, the _BaseOS repository_ contains the core set of the underlying operating system functionality that provides the foundation for all installations.
77+
78+
*Use it*: yes
79+
80+
*Incorrect forms*: Baseos, baseos, baseOS
81+
82+
*See also*:
83+
7484
[[basic-http-authentication]]
7585
==== image:images/yes.png[yes] Basic HTTP authentication (noun)
7686
*Description*: _Basic HTTP authentication_, or _Basic authentication_, is an authorization scheme that uses HTTP to send login credentials encoded in Base64.
@@ -138,6 +148,16 @@ The practice of having both modes together is often referred to as _hybrid_, _ag
138148

139149
*See also*:
140150

151+
[[binary-rpm]]
152+
==== image:images/yes.png[yes] binary RPM (noun)
153+
*Description*: A _binary RPM_ is an RPM package that contains the binaries built from sources and patches.
154+
155+
*Use it*: yes
156+
157+
*Incorrect forms*:
158+
159+
*See also*: xref:rpm[RPM]
160+
141161
[[bind]]
142162
==== image:images/yes.png[yes] BIND (noun)
143163
*Description*: Use "BIND" when referring to the DNS software.
@@ -203,6 +223,16 @@ Do not use "BIOS" as a generic term to refer to computer firmware. Use "firmware
203223

204224
*See also*: xref:filestore[FileStore], xref:object-store[Object Store]
205225

226+
[[boolean-dependencies]]
227+
==== image:images/yes.png[yes] Boolean dependencies (noun)
228+
*Description*: In Red Hat Enterprise Linux, _Boolean dependencies_ are Boolean expressions such as `if`, `and`, `or`, and other expressions that are used in the `Requires`, `Conflicts`, and `Weak` dependency directives. Boolean dependencies are also known as _Rich dependencies_.
229+
230+
*Use it*: yes
231+
232+
*Incorrect forms*:
233+
234+
*See also*: xref:weak-dependencies[Weak dependencies]
235+
206236
[[boot-disk]]
207237
==== image:images/yes.png[yes] boot disk (noun)
208238
*Description*: A _boot disk_ is a disk used to start a computer.
@@ -476,3 +506,13 @@ Do not use "BIOS" as a generic term to refer to computer firmware. Use "firmware
476506
*Incorrect forms*: byte code
477507

478508
*See also*:
509+
510+
[[byte-compiled-program]]
511+
==== image:images/yes.png[yes] byte-compiled program (noun)
512+
*Description*: _Byte-compiled programs_ are programs that must be compiled into bytecode before they can run in a language virtual machine.
513+
514+
*Use it*: yes
515+
516+
*Incorrect forms*:
517+
518+
*See also*: xref:interpreted-code[interpreted code]

supplementary_style_guide/glossary_terms_conventions/general_conventions/c.adoc

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -398,6 +398,16 @@
398398

399399
*See also*:
400400

401+
[[codeready-linux-builder-repository]]
402+
==== image:images/caution.png[with caution] CodeReady Linux Builder repository (noun)
403+
*Description*: In Red Hat Enterpise Linux, the _CodeReady Linux Builder repository_ provides additional packages for use by developers. Red Hat does not support packages included in the CodeReady Linux Builder repository. Do not use a shortened form of this term. Always mention that packages in this repository are unsupported.
404+
405+
*Use it*: with caution
406+
407+
*Incorrect forms*: codeready Linux builder, CRB
408+
409+
*See also*:
410+
401411
[[codebase]]
402412
==== image:images/yes.png[yes] codebase (noun)
403413
*Description*: A _codebase_ is a complete collection of source code for a software component, application, or system. Write as shown: one word.

supplementary_style_guide/glossary_terms_conventions/general_conventions/d.adoc

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -221,7 +221,7 @@ The API object for a deployment can be either a Kubernetes-native `Deployment` o
221221
// EAP: Added "In Red Hat JBoss Enterprise Application Platform,"
222222
[[deployment-scanner]]
223223
==== image:images/yes.png[yes] deployment-scanner subsystem (noun)
224-
*Description*: In Red Hat JBoss Enterprise Application Platform, the _deployment-scanner subsystem_ is used to configure scanners to check for applications to deploy. In general text, write in lowercase as two words separated by a hyphen. Use "Deployment Scanners subsystem" when referring to the `deployment-scanner` subsystem in titles and headings. When writing the term in its heading form, ensure that you include a plural 's'.
224+
*Description*: In Red Hat JBoss Enterprise Application Platform, the _deployment-scanner subsystem_ is used to configure scanners to check for applications to deploy. In general text, write in lowercase as two words separated by a hyphen. Use "Deployment Scanners subsystem" when referring to the `deployment-scanner` subsystem in titles and headings. When writing the term in its heading form, ensure that you include a plural 's'.
225225

226226
*Use it*: yes
227227

@@ -369,7 +369,6 @@ The API object for a deployment can be either a Kubernetes-native `Deployment` o
369369
*See also*:
370370

371371
// RHEL: Added "In Red Hat Enterprise Linux,"; Lowercased entry to "directory server" and updated in description
372-
// TODO: See if it was right to lowercase this
373372
[[directory-server]]
374373
==== image:images/yes.png[yes] directory server (noun)
375374
*Description*: In Red Hat Enterprise Linux, a _directory server_ centralizes user identity and application information. It provides an operating system-independent, network-based registry for storing application settings, user profiles, group data, policies, and access control information. Each resource on the network is considered an object by the directory server. Information about a particular resource is stored as a collection of attributes associated with that resource or object.
@@ -446,6 +445,16 @@ Red Hat Directory Server conforms to LDAP standards.
446445

447446
*See also*:
448447

448+
[[dnf-automatic]]
449+
==== image:images/yes.png[yes] DNF Automatic (noun)
450+
*Description*: Use _DNF Automatic_ to refer to a Red Hat Enterprise Linux command-line interface suited for automatic and regular package updates.
451+
452+
*Use it*: yes
453+
454+
*Incorrect forms*: DNF automatic, dnf automatic
455+
456+
*See also*:
457+
449458
[[dns]]
450459
==== image:images/yes.png[yes] DNS (noun)
451460
*Description*: _DNS_ is an abbreviation for "Domain Name System" or "Domain Name Service", a service that translates domain names into IP addresses and vice versa.
@@ -492,7 +501,7 @@ Red Hat Directory Server conforms to LDAP standards.
492501
// RHEL: Added "In Red Hat Enterprise Linux,"
493502
[[domain-controller]]
494503
==== image:images/yes.png[yes] domain controller (noun)
495-
*Description*: In Red Hat Enterprise Linux, a _domain controller (DC)_ is a host that responds to security authentication requests within a domain and controls access to resources in that domain.
504+
*Description*: In Red Hat Enterprise Linux, a _domain controller (DC)_ is a host that responds to security authentication requests within a domain and controls access to resources in that domain. IdM servers work as DCs for the IdM domain. A DC authenticates users, stores user account information and enforces security policy for a domain. When a user logs into a domain, the DC authenticates and validates their credentials and either allows or denies access.
496505

497506
*Use it*: yes
498507

@@ -521,7 +530,6 @@ Red Hat Directory Server conforms to LDAP standards.
521530

522531
*See also*:
523532

524-
525533
[[download-n]]
526534
==== image:images/yes.png[yes] download (noun)
527535
*Description*: Use "download" as a noun when referring to software, data, and so on that is being retrieved from another computer.

supplementary_style_guide/glossary_terms_conventions/general_conventions/f.adoc

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -86,6 +86,16 @@ Use the hyphenated "fault-tolerant" when using it as an adjective.
8686

8787
*See also*: xref:bluestore[BlueStore]
8888

89+
[[file-trigger-directive]]
90+
==== image:images/yes.png[yes] file trigger directive (noun)
91+
*Description*: In Red Hat Enterprise Linux, a _file trigger directive_ is a special form of a transaction scriptlet that runs conditionally when matching files from other packages are installed or uninstalled.
92+
93+
*Use it*: yes
94+
95+
*Incorrect forms*:
96+
97+
*See also*:
98+
8999
[[firewalld]]
90100
==== image:images/yes.png[yes] firewalld (noun)
91101
*Description*: The _firewalld_ service provides a dynamically managed firewall with support for zones that define the trust level of network connections or interfaces. Write as shown (all lowercase).

supplementary_style_guide/glossary_terms_conventions/general_conventions/i.adoc

Lines changed: 33 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,26 @@
88

99
*See also*: xref:paas[PaaS], xref:saas[SaaS]
1010

11+
[[ibm-cloud-bare-metal]]
12+
==== image:images/yes.png[yes] IBM Cloud® Bare Metal (Classic) (noun)
13+
*Description*: _IBM Cloud® Bare Metal (Classic)_ refers to a platform where a customer can run an OpenShift Container Platform cluster on an IBM bare-metal server. Ensure that "IBM Cloud®" precedes "Bare Metal (Classic)". On first use, mark "IBM Cloud" Bare Metal (Classic) with a registered trademark icon (®).
14+
15+
*Use it*: yes
16+
17+
*Incorrect forms*: IBM Cloud
18+
19+
*See also*:
20+
21+
[[ibm-eserver-system-i]]
22+
==== image:images/no.png[no] IBM eServer System i (noun)
23+
*Description*: This is a former product name; instead use the official product name "IBM Power".
24+
25+
*Use it*: no
26+
27+
*Incorrect forms*: IBM eServer System I
28+
29+
*See also*: xref:ibm-power[IBM Power], xref:iseries[iSeries]
30+
1131
[[ibm-eserver-system-p]]
1232
==== image:images/no.png[no] IBM eServer System p (noun)
1333
*Description*: This is a former product name; instead use the official product name "IBM Power".
@@ -524,6 +544,16 @@ _This feature can run only on Intel 64 processors_
524544

525545
*See also*:
526546

547+
[[interpreted-code]]
548+
==== image:images/yes.png[yes] interpreted code (noun)
549+
*Description*: In Red Hat Enterprise Linux, _interpreted code_ is source code that runs step-by-step, without prior transformations by a language interpreter or a language virtual machine.
550+
551+
*Use it*: yes
552+
553+
*Incorrect forms*:
554+
555+
*See also*: xref:raw-interpreted-program[raw-interpreted program], xref:byte-compiled-program[byte-compiled program]
556+
527557
// RHEL: Added "In Red Hat Enterprise Linux, an inventory is"
528558
[[inventory]]
529559
==== image:images/yes.png[yes] inventory (noun)
@@ -627,14 +657,14 @@ _This feature can run only on Intel 64 processors_
627657
*See also*:
628658

629659
[[iseries]]
630-
==== image:images/no.png[no] ISeries (noun)
660+
==== image:images/no.png[no] iSeries (noun)
631661
*Description*: This is a former product name; instead use the official product name "IBM Power".
632662

633663
*Use it*: no
634664

635-
*Incorrect forms*: iSeries
665+
*Incorrect forms*: ISeries
636666

637-
*See also*: xref:ibm-power[IBM Power]
667+
*See also*: xref:ibm-power[IBM Power], xref:ibm-eserver-system-i[IBM eServer System i]
638668

639669
[[iso]]
640670
==== image:images/yes.png[yes] ISO (noun)

supplementary_style_guide/glossary_terms_conventions/general_conventions/m.adoc

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -474,6 +474,36 @@ Azure CLI 2.0 is the most current command-line interface and is replacing Xplat-
474474

475475
*See also*:
476476

477+
[[module]]
478+
==== image:images/yes.png[yes] module (noun)
479+
*Description*: In Red Hat Enterprise Linux, a _module_ is a collection of packages representing a logical unit: an application, a language stack, a database, or a set of tools. These packages are built, tested, and released together.
480+
481+
*Use it*: yes
482+
483+
*Incorrect forms*:
484+
485+
*See also*:
486+
487+
[[module-profile]]
488+
==== image:images/yes.png[yes] module profile (noun)
489+
*Description*: In Red Hat Enterprise Linux, a _module profile_ is a list of recommended packages to be installed together for a particular use case such as for a server, client, development, or minimal installation. These package lists can contain packages outside the module stream, usually from the BaseOS repository or the dependencies of the stream.
490+
491+
*Use it*: yes
492+
493+
*Incorrect forms*:
494+
495+
*See also*: xref:baseos-repository[BaseOS repository]
496+
497+
[[module-stream]]
498+
==== image:images/yes.png[yes] module stream (noun)
499+
*Description*: In Red Hat Enterprise Linux, _module streams_ are filters that can be thought of as virtual repositories in the AppStream physical repository. Module streams represent versions of the Application Stream components.
500+
501+
*Use it*: yes
502+
503+
*Incorrect forms*:
504+
505+
*See also*:
506+
477507
// RHV: Added "In Red Hat Virtualization,"
478508
[[mom]]
479509
==== image:images/yes.png[yes] MOM (noun)

supplementary_style_guide/glossary_terms_conventions/general_conventions/n.adoc

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -63,6 +63,16 @@
6363

6464
*See also*: xref:management-cli[management CLI]
6565

66+
[[natively-compiled-code]]
67+
==== image:images/yes.png[yes] natively compiled code (noun)
68+
*Description*: _Natively compiled code_ is code written in a programming language that compiles to machine code with a resulting binary executable file. Such code can be run standalone.
69+
70+
*Use it*: yes
71+
72+
*Incorrect forms*: natively-compiled code
73+
74+
*See also*:
75+
6676
[[need]]
6777
==== image:images/yes.png[yes] need (verb)
6878
*Description*: Use "need" instead of "desire" or "wish". Use "want" when the reader's actions are optional; that is, one might not need something but might still want something.

supplementary_style_guide/glossary_terms_conventions/general_conventions/o.adoc

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -410,6 +410,16 @@ NOTE: When referring generally to other Kubernetes components, such as pods, nod
410410

411411
*See also*:
412412

413+
[[opt-in]]
414+
==== image:images/yes.png[yes] opt in (verb)
415+
*Description*: For Amazon Web Services (AWS), _opt in_ refers to manually selecting AWS opt-in Regions, which are usually locations that can offer higher security requirements than default commercial AWS Regions. A Red Hat customer who wants to deploy an OpenShift Container Platform cluster in an AWS Region or AWS Local Zone location must opt in to the location by configuring their AWS management account. For the gerund form of the phrase, use "opting in".
416+
417+
*Use it*: yes
418+
419+
*Incorrect forms*: opt into, opting into
420+
421+
*See also*: xref:aws-opt-in-region[AWS opt-in Region], xref:aws-local-zone[AWS Local Zone]
422+
413423
[[organization-administrator]]
414424
==== image:images/yes.png[yes] Organization Administrator (noun)
415425
*Description*: From https://access.redhat.com/articles/1757953[Roles and Permissions for Red Hat Customer Portal]: Organization Administrator: This is the highest permission level for a Red Hat account with full access to content and features. This is the only role that can manage users and control their access and permissions on an account.

0 commit comments

Comments
 (0)